10 PROGRAM ENVIRONMENT AND INITIAUZATIQN 


Th i s sec tion discusses possible alternative Software environments 
using OS Configurations. Environments other than those discussed 
her e are also possible. A thorough understanding of the power—up 
and system reset processes <see Section 7i will be necessary to 
evaluate all alternative environments. 


CARTRIDGE 

Most garnes (and some language processors) are supported via the 
cartridge environment. The cartridge resident Software is in 
control of the System, sometimes using the OS and sometimes not. 
A cartridge can specify whether the diskette is to be booted at 
powei—up time, whether the cartridge is to provide the 
Controlling Software, or whether the cartridge is a special 
diagnostic cartridge. These options are specified by bits in the 
cartridge header, as shown below: 


4.-j. 

! cartridge ! 

+- -+ 

! Start address J 

+ -4. 

\ 00 ! 

+ * — — — + 

* option byte ! 

4.-4. 

\ cartridge ! 

+~ -+ 

! init address i 

Figure 1Q-1 Cartridge Header Format 

The byte of "00" is used to allow the OS to determine when a 
cartridge is inserted; locations BFFC and 9FFC will not read zero 
when there is neither RAM at those locations nor a cartridge 
inserted. RAM is differentiated from a cartridge by its ability 
to be altered. 


BFFA (9FFA for cartridge B) 


BFFF (9FFF for cartridge B> 
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The Option byte has the following Option bits: 


b it 0 


0; then do not boot the diskette. 
1, then boot the diskette. 


Bit 2 


0/ then init but do not start the cartridge. 
1, then init and start the cartridge. 


bit 7 


0/ then cartridge is not a diagnostic cartridge. 

1* then cartridge is a diagnostic cartridge and controi 
will be given to the cartridge before any of the GS 
is initialized (JMP (BFFEM. 


The cartridge init address specifies the location to which the GS will 
JSR during all power-up and System reset operations. As a minimum, 
this vector should point to an RTS instruction. 

The cartridge start address specifies the location to which the OS 
will JMP during all power-up and system reset operations/ if 
bit 1 of the Option byte is = i. The application should examine 
the variable WÄRMST CG0083 if system reset action is to be 
different than power-up (WÄRMST will be zero on power-up and 
nonzero thereafter >, 


Cartridge Without Booted Support Package 

A cartridge that does not specify the diskette-boot Option and does 
not support the cassette-boot possibility can use lower memory 
(from 0480 to the address in MEMTOP C02E53) in any way it sees 
fit. 


Cartridge With Booted Support Package 

A cartridge that does specify the diskette-boot Option or does 
support the cassette-boot possibility must use some care in its 
use of lower memory. The following regions are defined: 

048Ö-06FF is always available to the cartridge. 
MEMLG/MEMTOP region is always available to the cartridge. 


DISKETTE-BOGTED SOFTWARE 

Software can be booted from the disk drive at power-up time in 
response to one of the following conditions: 
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Neither Cartridge A nor B is inserted. 

Cartridge A is inserted and has bit 0 of its Option bgte 
EBFFD1 = 1. 

Cartridge B is inserted and has bit 0 of its Option byte 
C9FFD3 = i. 

If any of these conditions are met< the OS will attempt to read 
the boot record from sector #1 of disk drive 1 and then transfer 
control to the Software that was read in. The exact sequence of 
operations will be explained later in this section. 


Diskette-Boot File Format 

The key region of a diskette-boot file is the first six bytes. which 
are formatted as shown below: 


Figure 10-2 


+- 

I 

I 

+ - 


f lags 

# of sectors 
memory address 
to start load 
init 


-+ 


+- 


address 


boot 

continuation 

code 


first 


s i x th 


Diskette-Boot File Format 


byte 


byte 


The first byte is stored in DFLAGS C02401* but is otherwise 
unused. It should equal zero. 

The second byte contains the nuntber of 128— byte diskette sectors 
to be read as part of the boot process (including the record 
containing this Information). This number can ränge from 1 to 
253* with 0 meaning 256. 
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The third and fourth bytes contain the address (Io, hi) at which to 
start loading the first byte of the file. 

The fifth and sixth bytes contain the address (lo/hi) to which the 
booter will transfer control after the boot process is complete 
and whenever the CSYSTEM. RESET1 key is pressed. 

The Diskette File Management System (FMS) has extra bytes assigned to 
its boot rscardi but this is a special case of the generalized 
diskette-boot and is discussed in Section 5. 


Diskette-Boot Process 

If no cartridge is installed» then the diskette will follou these 
steps to boot up: 

1. Read the first diskette record to the cassette buffer C 0400 3. 

2. Extract information from the first six bytes: 

Save the flags byte to DFLAGS C0240*13. Save the # of sectors 
to boot to DBSECT C0241,11. Save the load address to BOOTAD 
10242,23. Save the initia1ization address in DOSINI C000C,23. 

3. Move the record just read to the load address specified. 

4. Read the remaining records directly to the load area. 

5. JSR to the load address+6 where a multistage boot process can 
continue, The carry bit indicates the success of this 
Operation (carry set ~ error» carry reset =* success). 

NOTE: Düring Step 5» after the initial boot process is 

complete, the booter will transfer control to the seventh byt 
of the first record. The Software should continue the boot 
process at this point, if it is a multistage boot. The value 
of MEMLG CQ2E73 should point to the first free RAM location 
beyond the Software just booted. It should be established by 
the booted Software as shown below: 


LDA 

#END+1 

; SET 

UP 

LSB 

STA 

MEMLÜ 




STA 

APPMHI 




LDA 

#END+1/256 

; SET 

UP 

MSB 

STA 

MEMLO+1 




STA 

APPMHI+1 





If the booted Software is to take control of the 
System at the end of the boot Operation» the 
vector DQSVEC CQÖQA3 must be set up by the 
application at this time; DOSVEC points to the 
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restart entry for the booted application. If the 
booted Software is not to take control, then 
DOSVEC should remain unchanged. 


LDA 

#R£STRT 

; RESTART LSB 

STA 

DOSVEC 


LDA 

#RESTRT/256 


STA 

DOSVEC+1 



6. JSR indirectly through DOSINI for initia1ization of the 
application; the application will initialize and return. 

NOTE: The ÜS enters the initia1ization point on every 
System reset and power-up. Interna 1 initialization can take 
place during System reset and power-up as well. Initia1ization 
can also he deferred until Step 7 for Controlling 
app1ications. 


7. JMP indirectly through DOSVEC to transfer control to the 
application. 

NOTE: Pressing the tSYSTEM.RESET3 key after the application 

is fully hooted will cause steps 6 and 7 to he repeated. 


Sample Diskette-Bootable Program Listing 

This sfceletal program can he hooted from the diskette, It retains 
control when it is entered. 


i THIS IS THE START OF THE PROGRAM FILE. 

PST= $0700 i (OR SOME OTHER LOCATION). 

** PST ; <. ORG). 


; THIS IS THE diskette-boot CONTROL INFORMATION. 


. BYTE 0 

. BYTE PND-PST+127/128 
. WORD PST 
.WORD PINIT 


NUMBER OF RECORDS. 

MEMORY ADDRESS TO START LOAD. 
PROGRAM INIT. 
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i THIS IS THE START ÖF THE BOOT CGNTINUATIÖN. 


LDA 

#PND 

i ESTABLISH LOW MEMORY LIMITS. 

STA 

MEMLO 


STA 

APPMHI 


LDA 

#PND/256 


STA 

MEMLO+1 


STA 

APPMHI+1 


LDA 

#RESTRT 

i ESTABLISH RESTART VECTOR. 

STA 

DOSVEC 


LDA 

#RESTRT/256 


STA 

DOSVEC+1 


CLC 


i SET FLAG FOR SÜCCESSFÜL BOOT 

RTS 



; APPLICATION 

INITIALIZATION 

ENTRY POINT. 

PINIT RTS 


i NOTHING TO DO HERE FOR . . . 


«W L/w i IMU- l Ull * . » 

CONTROLLING APPLICATION. 


i THE MAIN BODY OF THE PROGRAM FOLLOWS. 

RESTRT=* 

; THE MAIN BODY OF THE PROGRAM ENDS HERE. 

PND= * i 'PND' = NEXT FREE LOCATION. 

. END 

Figure 10-3 Diskette-Bootable Program Listing Example 


Program to Create Diskette-Boot Files 

This section gravides a program that can be used to make bootab1e 
•Files on diskettes. The program given is not the only one possible, 
and no daiis are made as to its elegance. 
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Shown belotu is a listing o-f the program to crsate d i s ketta-b oot files 


; THIS PROGRAM WRITES A SINGLE "FILE“ TO THE DISKETTE AND IS 
) USED IN CÖNUUNCTIÖN WITH A PROCEDURE TO MAKE DISKETTE- 
i 800TABLE FILES. THE FQLLÜWING TWO SYMBOLS MUST BE EQUATED 
i USING THE MEMORY LIMITS OF THE PROGRAM TO BE COPIED: 

; 'PST' = PROGRAM START ADDRESS (SEE SAMPLE PROGRAM), 

i 'PND' = PROGRAM END ADDRESS (SEE SAMPLE PROGRAM). 


SECSIZ=12B ; DISKETTE SECTOR SIZE. 

PST= $0700 
PND= $1324 

FLEN= PND-PST+SECSIZ~1/SECSIZ ; # OF SECTORS IN FILE. 
*" $B000 ; THIS PRQGRAM 'S ORIGIN. 


BOOTB BRK 

i SET UP DEVICE CONTROL BLOCK 


LDA 

#FLEN 

STA 

COUNT 

LDA 

#1 

STA 

DUN IT 

LDA 

#'W 

STA 

DCOMND 

LDA 

#PST 

STA 

DBUFLO 

LDA 

#PST/256 

STA 

DBUFHI 

LDA 

#01 

STA 

DAUX1 

LDA 

#00 

STA 

DAUX2 


i *** LOAD APPLICATION 
FOR DISKETTE HÄNDLER CALL 
i # OF SECTORS TO WRITE. 

i DISK DRIVE #1. 

SET UP FOR WRITE WITH CHECK, 
i POINT TO START OF APPLIC. PROG. 

i SET UP STARTING SECTOR # = 0001 
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; NOW WRITE THE FILE ONE SECTÜR AT A TIME. 


BÜT010 

JSR 

DSKINV 

i 

WRITE ONE SECTOR 



BMI 

DERR 

j 

ERROR. 



LDA 

DBUFLO 

i 

INCREMENT MEMORY 

ADDRESS. 


CLC 






ADC 

#SECSIZ 





STA 

DBUFLO 





LDA 

DBUFHI 





ADC 

#0 





STA 

DBUFHI 





INC 

DAUX1 

t 

INCREMENT SECTOR 

#. 


BNE 

B0T020 





INC 

DAUX2 




BQT020 

DEC 

COUNT 

i 

MORE SECTORS TO 

WRITE? 


BNE 

B0T010 

t 

YES. 



BRK 


i 

STOP WHEN DONE. 


DERR 

BRK 


j 

STOP ON ERROR. 


COUNT 

*=*+i 


r 

SECTOR COUNT. 


; THIS 

IS THE 

CARTRIDGE 

HEADER 



*= 

*BFF9 


i 

"A" CARTRIDGE. 


INIT 

RTS 






. WORD 

BÖOTB 





. BYTE 

0, 4 





. WORD 

INIT 





. END 






CASSETTE-BOOTED SOFTWARE 

Ygu can boot Software from the cassette as well as from the 
diskette* at power-up. The follouiing requirements must be met in order 
to boot from the cassette: 

o You must be pressing the CSTART3 key as potuer is 
applied to the system. 

o A cassette tape with a proper boot formet file must be 

installed in the cassette drive f and the PLAY button must be 
pressed. 
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o When you are given the audio prompt by the cassette 
handler you must press the CRETURN3 key. 

If all of these conditions are met» the OS will read the boot file 
from the cassette and then transfer control to the Software that 
was read in. The exact sequence of operations will be explained 
later in this section. 


Cassette-Boot File Format 

The key region of a cassette-boot file is the first six bytes» that 
are formatted as shown below: 


# of Records 


Memory Address ! 
To Start Load i 


+— 


In i t i 

—+ 

address ! 

- + 


The first byte is not used by the cassette-boot process. 

The second byte contains the number of 128-byte cassette records to 
be read as part of the boot process <including the record 
containing this Information >. This number can ränge from 1 to 255» 
with 0 meaning 256. 

The third and fourth bytes contain the address <io»hi) to which the 
booter will transfer control after the boot process is complete and 
whenever the CSYSTEM. RESET3 key is pressed. 


Cassette-Boot Process 

The cassette-boot process is described step-by-step for a 
configuration in that no cartridge is installed and no diskettes are 
attached. For the general case see Section 7. 

1. Read the first cassette record to the cassette buffer. 

2. Extract Information from the first six bytes: 


OPERATING SYSTEM CÖ16555 — Section 10 


165 









Save the # of records to boot. Save the load address. Save 
the initialization address in CASINI C00023 

3. Move the record just read to the load address specified. 

4. Read the remaining records directly to the load area. 

5. JSR to the load address+6 wh er e a multistage boot process 
can continue; the carry bit will indicate the success of 
this Operation (carry set=error. carry reset=success). 

h. JSR indirectly through CASINI for initia1ization of the 
applicationi the application will initialize and return. 

7. JMP indirectly through DOSVEC to transfer control to the 
app1ication. 

Pressing the CSYSTEM.RESET! key after the application is fully booted 
will cause steps 6 and 7 to be repeated. 

NOTE: After the initial boot process is complete. the booter will 

transfer control to the seventh byte of the first record; at this 
point the Software should continue the boot process (if it is a 
multistage boot) and then stop the cassette drive, which due to a 
System bug will still be running, using the following instruction 
sequenc e: 

LDA #$3C 

STA PACTL ED3023 

The application should then set a value in MEMLO C0237! that 
points to the first free RAM location beyond the Software just 
booted. as shown below: 

LDA #END+1 

STA MEMLO 

STA APPMHI 

LDA #END+l/256 

STA MEMLÖ+1 

STA APPMHI+1 

If the booted Software is to take control of the System at the end 
of the boot Operation, the vector DOSVEC COOÖAJ must be set up by 
the application at this time; DOSVEC points to the restart entry 
for the booted application. If the booted Software is not to take 
control. then DOSVEC should remain unchanged. 

LDA #RESTRT ; RESTART LSB 

STA DOSVEC 

LDA #RESTRT/256 

STA DOSVEC*1 


NÖTE: The initia1ization point is entered on every system reset 
and power-up; internal initialization can take place here. 
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For Controlling applications in i tia 1 ization can also be deferred 
until step 7. 


Sample Cassette-Bootable Program Listing 

Shoum belotK is a skeletal program that can be booted from the 
cassette and that retains control üben it is entered. 

; THIS IS THE START OF THE PROGRAM FILE. 

PST= *0700 ; <0R SOME OTHER LOCATION). 

PST i <.ÖRG). 


; THIS IS THE cassette-boot CONTROL INFORMATION. 

■BYTE O i IDOESN'T MATTER). 

.BYTE PND-PST•+•127/128 ; NUMBER OF RECORDS. 

. WORD PST f MEMORY ADDRESS TO START LOAD. 

. WORD PINIT i PROGRAM INIT. 

i THIS IS THE START OF THE BOOT CONTINUATION. 


LDA 

#*3C 

i STOP THE 

CASSETTE. 

STA 

PACTL 



LDA 

#PND 

i ESTABLISH 

LOW MEMORY LIMITS. 

STA 

MEMLO 



STA 

APPMHI 



LDA 

#PND/256 



STA 

MEMLO+1 



STA 

APPMHI+1 



LDA 

#RESTRT 

i ESTABLISH 

RESTART VECTOR. 

STA 

DOSVEC 



LDA 

#RESTRT/256 



STA 

DQSVEC+1 



CLC 


; SET FLAG 

FOR SUCCESSFUL BOOT 

RTS 





; APPLICATION INITIALIZATION ENTRY POINT. 

PINIT RTS ; NOTHING TO DO HERE FOR ... 

; ... CONTROLLING APPLICATION. 

; THE MAIN BODY OF THE PROGRAM FOLLOWS. 

RESTRT=* 

; THE MAIN BODY OF THE PROGRAM ENDS HERE. 
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PND= 


» 

. END 


PND 


NEXT FREE LOCATION. 


Figure 10-4 Sample Cassette-Bootab1e Program 


Program to Create Cassette-Boot Files 

This section provides a program listing that can be used to make 
bootable files on cassette tapes. The program given is not the on 
one possible. and no Claims are made as to its elegance. 

Shoun below is a listing of the program to create a cassette-boot 
f ile: 

; THIS PROGRAM WRITES A SINGLE FILE TO THE CASSETTE AND IS 
; USED IN CONÜUNCTION WITH A PROCEDURE TO MAKE CASSETTE- 
; BOOTABLE FILES. THE FOLLOWING TWO SYMBOLS MUST BE EGUATED 
i USING THE MEMORY LIMITS OF THE PROGRAM TO BE COPIED: 

; 'PST' = PROGRAM START ADDRESS (SEE SAMPLE PROGRAM). 

; 'PND' = PROGRAM END ADDRESS (SEE SAMPLE PROGRAM). 

PST= *0700 
PND= *1324 

FLEN= PND-PST+i27/128*128 ; ROUND UP TO MULTIPLE OF 128. 

*= *B000 i THIS PROGRAM'S ORIGIN. 


BOOTB 

LDX 

#*10 ; 

USE IOCB #1. 

i FIRST OPEN 

THE CASSETTE FILE 

FOR WRITING. 


LDA 

#OPEN i 

SET UP FOR DEVICE “OPEN. " 


STA 

ICCQM/X 



LDA 

#OPNQT ; 

DIRECTIQN IS "OUTPUT. “ 


STA 

ICAX1,X 



LDA 

#*80 i 

SELECT SHORT IRG. 


STA 

ICAX2.X 



LDA 

#CFILE i 

SET UP POINTER TO DEVICE NAME. 


STA 

ICBALi X 



LDA 

#CFIL£/256 



STA 

ICBAHi X 



JSR 

CIOV i 

ATTEMPT TO OPEN FILE. 


BMI 

CERR i 

ERROR. 

; NON 

WRITE 

THE ENTIRE FILE AS 

ONE OPERATION. 
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LDA 

STA 

#PUTCHR 

ICCOM»X 

i 

SET UP 

FOR "PUT CHARACTERS. " 

LDA 

STA 

LDA 

STA 

#PST 

ICBAL. X 
#PST/256 
ICBAH, X 

} 

POINT 

TO START OF APPLIC. PRGG 

LDA 

STA 

LDA 

STA 

#FLEN 

ICBLL» X 
#FLEN/256 
ICBLH. X 

} 

SET UP 

# OF BYTES TO WRITE. 

JSR 

CIOV 

i 

WRITE 

ENTIRE FILE. 

BMI 

CERR 

i 

ERROR. 



i NOW CLOSE THE FILE AFTER SUCCESSFUL WRITE. 



LDA 

STA 

#CLOSE i 

ICCOM»X 

SET UP FOR "CLOSE 


JSR 

BMI 

CIOV i 

CERR ; 

CLOSE THE FILE. 
ERROR. 


ERK 

i 

STOP WHEN DONE. 

CERR 

BRK 

j 

STOP ON ERROR. 

CFILE 

. BYTE 

"C:"» CR i 

FILE NAME. 

i THIS 

IS THE 

CARTRIDGE HEADER 



*BFF9 

/ 

"A" CARTRIDGE. 

INIT 

RTS 
. WORD 
. BYTE 

BOQTB 

0, 4 



. WORD 
. END 

INIT 
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11 ADVANCED TECHNIQUES AND APPLICATION NOTES 

This section presents Information to use the capabilities of the OS 
and some of the hardware capabilites that aren't directly available 
through the OS ,and in fact« can be in direct conflict with Darts of 
the OS. 


SOUND GENERATION 

The OS uses the POKEY sound generation capabilities only in the I/O 
Subsystem« for cassette FSK tone generation« and for the "noisy 
bus" Option in SIO. 


Capabi1ities 

The hardware provides four independent1y programmable audio 
channels that are mixed and sent to the television set as part of 
the composite video signal. The POKEY registers shown below are all 
concerned with sound control <as described in the ATARI Home 
Computer Hardware Manual). 

AUDCTL ED2081 

AUDC1 CD2013 and AUDFi CD2Ü0J 

AUDC2 CD203] and AUDF2 CD2021 

AUDC3 CD2051 and AUDF3 [02041 

AUDC4 CD2073 and AUDF4 CD20&1 


Conflicts With OS 

There are two potential conflicts with the OS involving sound 
generation: 

The OS can generate its own sounds and then turn off all sounds 
as part of I/O operations to the cassette and the serial bus 
peripherals. 

The OS does not turn off sounds when you press [SYSTEM.RESET3 or 
CBREAK3. If the sounds are to be turned off under those 

conditions« the Controlling program must provide that capability. 


Audio control. 
Channel 1 control. 
Channel 2 control. 
Channel 3 control. 
Channel 4 control. 


170 


OPERATING SYSTEM C016555 — Section 11 



SCREEN GRAPHICS 


Hardware Capabilities 

The hardware capabilities for screen presentations are quite 
versatile; the OS uses a very small amount of the capability 
provided. The means of extension ( however* are non—trivial; and 
mafcing changes to a screen format while still utilizing the 
resident Display Händler will be difficult. See the ATARI Home 
Computer Hardware Manual for Information regarding screen 
presentations. 


OS Capabilities 

The resident Display Händler arbitrarily Supports S of the 11 
possible full screen modes (11 of 14 modes if the GTIA Chip is used 
in place of the CTIA). The resident Display Händler allows for an 
optional "sp1it-screen" text window of fixed size. The hardware 
a1lows for many more options than the Display Händler supportsi as 
will be seen by reading the ATARI Home Computer Hardware 
Manua1. 


Cursor Control 

You can control the Display Händler text and graphics Cursors 
directly (see Section 5 and Appendix L, Bl-4>. 


Color Control 

You can alter the color register assignments that the Display 
Händler makes upon all OPEN commands (see Appendix L B7-8 and 
elsswhere). Note that every system reset or Display Händler OPEN 
will reset the values back to the System default. 
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Alternate Character Sets 


Tüio character sets are available in screen text modes 1 and 2. The 
value stored in the data base variable CHBAS E02F4 1 selects the 
character set of interest to you. The default value of $E0 
provides Capital (uppercase) letters, numbers and the punctuation 
characters corresponding to display Codes $20 through $5F in 
Appendix E>. The alternate value cf $E2 provides lourercase letters 
and the special character graphics set (corresponding to display 
Codes $60 through $7F and $00 through $1F in Appendix E>. 

User—defined character sets can also be obtained for text modes Q, 
i. and 2 by providing the character matrix definitions in RAM and 
setting CHBAS to point to those definitions. CHBAS aluays contains 
the most significant bits of the memory address of the Start of th 
character definitions, as shown beloui: 


7 0 

+—►-+—i—+-+—h—l— y- 

CHBAS ! MSB !x x! Text mode 0 

+ —+ I ►“ + | (. 

H—+—)—■+—|- ). 

< MSB !x{ Text modes 1 and 2 


Figure il-1 User-Defined Character Set Bit Memory Addresses 

<X indicates an ignored address bit 
assumed to be 0. ) 
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Each character is defined by an S x 8 bit matrix; the 
character 'S' is defined as shotun below: 


7 0 

Byte +— *■ —*-—+-+—+“•*■—i—► 

iOiOiOSOfÖiOiOiOi 0 

iOJO!1!i11!1!0!0! 1 

-t-—t-—h—+ 

io:iii iö: i;iiöio: 2 

■i —H K—H (■*—I J- 

jo; li1 so:1 i 1i0 s 0i 3 

+ _ + „ + _ + _ + _ + _ + „ + „ + 

:o:1{ito!1äijoioi 4 

!0!1!1iOiQiOfOiOi 5 

+ -+— y —I-I-I-— + 

1 0; 0 1 1 1 i 1 1; 1:0:0: 6 

+ _ + _ + _ + _ + -.+_+_+_+ 

IGiOiÖiÖSÖlOiöIO! 7 

+ _ + _ + _ 4 ._ + _+_+_+_+ 


Figure 11-2 User Defined 8x8 Cbaracter Matrix Bit Table 

The storage for the cbaracter set involves eight cansecutive 
bytes for each cbaracter uith characters ordered consecutive1y by 
their internal code value (see the discussion in Appendix L 
relating to B55). 

+ - + 

Character base ! Cbaracter for i 

i code $00 i 8 bytes 

+■ - + 

\ Character for ! 

! code $01 ! increasing addresses 

+--—-+ 

I t 

I • 


! Character for ! 

} code $7E ! 

+ - + 

i Character for ! 
i code $7F i 

+-+ 


Figure 11-3 Character Base Diagram 
PLAYER/MISSILE GRAPHICS 

Th e OS rna k es no use of the player/missile generation capability 
of the hardware. It can be used independent 1y of the OS with no 
conflict. 
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Hardware Capabilities 


The Hardware allous a number of independent 1y moveable screen 
objects of limited width to be positioned and moved about the 
screen without affecting the "playfield" {bit—mapped graphics or 
character) data. Priority control allows the various objects to 
have a display precedence in case of conflict {overlap*. 


Conflicts With QS 

You must assure that the player/missile data is 
address—a 1 igned as req,uired by PMEASE CD407I. You also must 
find a suitable free area that the ÖS guarantees to be free under 
all environments. 


READING GAME CONTROLLERS 

The QS reads the game Controllers (shoum below) as part of the 
stage 2 VBLANK process (see Appendix L Jl-91: 

Joysticks/triggers 1-4. 

Paddle controllers/triggers 1-S. 

Driving controllers/triggers 1-4. 

Light pen/trigger 

In addition to these Controllers! other Information can be sensed 
or sent using the PIA chip to that the console connectors are 
interfaced. 


Keyboard Controller Sensing 

Data can be read from an ATARI keyboard Controller connected to the 
first port. This program alters registers on a Chip called a PIA. 

To set these back to the default values to do further I/Ot hit 
CSYSTEM. RESET3 or PQKE PACTL,60. If this program is to be loaded from 
diskettei use LOAD, not RUN and wait for the busy light on the disk 
drive to go out. Do not execute the program before this light goes 
out/ otherwise the diskette continues to spin, 

1 GRAPHICS O 

5 PRINT :PRINT " KEYBOARD CONTROLLER DEMO" 

10 DIM RÖW{3>,I*{13>,BUTTQN*<1> 

30 GOSUB 6000 
40 FOR CNT=1 TO 4 

60 POSITION 2/CNT#2+5:PRINT "CONTROLLER # ";CNT;":"i 
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70 NEXT CNT 

80 FOR CNT=1 TO 4:GOSUB 7000:POSITION 19,CNT+CNT+5:PRINT BUTTON*; 

:NEXT CNT 
120 GOTO 80 

6000 REM ** SET UP FOR CONTROLLERS ** 

6010 P0RTA=54016:P0RTB=54017:PACTL=54018:PBCTL=54019 
6020 POKE PACTL,48:POKE PORTA,255:POKE PACTL,52:POKE PORTA,221 
6025 POKE PBCTL,48:PQKEPORTB,255:POKE PBCTL,52:POKE PORTB,221 
6030 ROWCO>=238:ROWC1)=221:R0W<2>=187:R0W<3>=119 
6040 I*=" 123456789*0#" 

6050 RETURN 

7000 REM ** RETURN BUTTON* WITH CHARACTER FOR BUTTON WHICH HAS 
BEEN PRESSED ON CONTROLLER CNT <i-4). ** 

7001 REM ** NOTE: A 1 WILL BE RETURNED IF NO CONTROLLER IS 
CONNECTED. ** 

7002 REM ** A SPACE WILL BE RETURNED IF THE CONTROLLER IS 
CONNECTED BUT NO KEY HAS BEEN PRESSED. ** 

7003 PORT=PORTA: IF CNT>2 THEN PÖRT=PGRTB 
7005 P-l 

7008 PA0=CNT+CNT-2 
7010 FOR J=0 TO 3 
7020 POKE PORT,RÜW(J) 

7030 FOR 1=1 TO 10:NEXT I 

7050 IF PADDLE(PA0+1)>10 THEN P=J+J+J-t-2; GOTO 7090 
7060 IF PADDLE(PAO)>10 THEN P=J+J+J+3:GOTO 7090 
7070 IF STRIG(CNT-1)=0 THEN P=J+U+J+4:GOTO 7090 
7080 NEXT J 
7090 BUTTON*=I*(P, P) 

7095 RETURN 

Figure 11—4 Reading Data From an ATARI Kegboard Controller 
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The tab 1 e bei our shows the var iab le/regist er va lues used for reading a 
keyboard Controller from each of the four Controller ports. 


Port 1 Port 2 Port 3 Port 4 

|-)—-j--1 ''I-h —«fr 1 ) | \ } ^ | 

1 PORT A ! \ t ! ! 

Idirectionl OF i FO t - * - ! 

J bits t ! . I i 

{ PORT B ■ 1 I t J 

idirectionl - 1 - 3 OF t FO 

ibits 1 ! i 

+ -H | (_—j.—>.„4.—*._ +—J.——| | ^—(.—| | ►—t- 

! Port A \ FE, FD, I EF, DF I 1 

I rou sei I FB,F7 S BF,7F f 1 - 1 

! ec t I t I 1 ! 

H-►—)-1-1-h—I-1-h—h —-i -)-► — ■)-1-1-t-t-—)-► —t- 

! Port B ! ! FE, FD, l EF, DF, i 

\ rou se- 1 - : - i FB,F7 t BF, 7F I 

i lect ! 1 I t i 

i Column ÜPADDL1 i PADDL3 SPADDL5 iPADDL7 i 
! Sense i , i ! ! 

I Column 2!PADDLO !PADDL2 !PADDL4 {PADDL6 i 
! Sense } i i i f 

i Column 3iSTRIGO iSTRIGl iSTRIG2 ISTRIG3 S 
! Sense i i ! ! i 

+ _ + _ + _ + _ + _ + „ + _ + _ + _ + _ + _ + _ + _ + _ + _ + _ + _ + „ + _ + _ + _ + 


Figure il-5 ATARI Keyboard Controller Variab1e/Register Value 

Tab le 


Front Panel Connectors as I/O Ports 

The three pages that f ol lau sh atu houi sollte of the pins in the front 
panel (game Controller) connectors can be used as general I/O pins. 


Hardware Information 

PIA (6520 / 6820) 

Out: TTL levels, 1 load 

In : TTL levels, 1 load For more Information refer 

to 6520 chip manual. 
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Port A Circuit (typicall: 


6520 


JlOTt 


220 

'wv 


^=001 


jac k 


Port B Circuit (typical): 

> +5 


< B > 


6520 


Port 


7K 

AAAq— 

220 ^001 



Ma1 e connectoTi FRONT vieu 

Pin 8 = Ground 

Pin 7 = Vcc 8+5v *■) 

Note: 50mA maximum 
total external drain 
on potuer supply allotued 


"Trigger" Port Circuit (typical*: 


CT IA Trig 


220 

-’VW 


5 


001 


Jack 


Software Information 


6520 PIA: (This also pertains to all of the following: > 

Port A control (address D302) 


7 

6 

5 

4 

3 

2 

% 

0 

M 

0 

Lii 

3 

L±J 

X 

0 

0 


i 


Write this into this register 


Port A Data/Data direction addres 
ing control 

0 - Data Direction is at 0300 
1 = data is at D3Ö0 


Port A data direction (address D300) 


7 

& 

5 

4 

3 

2 

1 

0 

IX 

ü* 

S 

X 

X 

X 

X 

JÜ 


Write this into this register. 


Data direction control 
for Port A 
1 = Out 
0 = In 
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Port A data (address D300) 
7 6 5 4 3 2 1 0 


J_I_I_I_!_1_■_: Read or Write this register 

43214321 
'-' \- J 

Jack 2 Jack 1 

Pin Numbers 


Port B Control (address D303) 


0 






6520 PIA: 

Port B Control (address D3Ö3) 
7 6 5 4 3 2 1 0 


1-1 


1-1 

1 

1 


1-1 

L?_ 

0 

. 1 

1 1 

laJ 

0 



Port 


turite this into this register 

B Data/Data direction 

addressing control 
0 = D301 contains data 
direction 

1 = $0301 contains 


Port B data direction (address D301 ■ 


7 6 5 4 3 2 1 


X 

X 

* 


X f X 

X 

wr i te 


T 

T 

X 

XX 

J 

L 



write this into this register 


data direction control for Port B 
1 - Out 
0 = In 


Port B data (address D301) 


7 6 5 4 3 2 1 0 

i i i i i n~) 

4 3 2 1 4 3 2 1 

V-_ J \ _^ 

Jack 4 J ack 3 

Pin Numbers 


Four “Trigger" ports: DÖIOi D011* DO12* DO13 


7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

■'0 


u 

0 

0 

□ 


jl 


Read this port 

Trigger Value 
D010 = Port 1 Pin 
DO13 = Port 4 pin 


6 

6 
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Other Mise e1laneous Software Information 


1>. The OS sets up all PIA ports as inputs during 
initialization. 

2). The OS usually reads the above once per television frame 
< during 

vertical-blank) into RAM as follows: 


Data Base Name 
STICKO 


Address 
0278 


Data 


STICK1 

0729 

STICK2 

027A 

STICK3 

027B 

STRIGO 

0284 

STRIG1 

0285 

STRIG2 

0286 

STRIG3 

0287 

PADDL.1 

0270 

PADDL3 

0272 

PADDL5 

0274 

PADDL7 

0276 

PADDLO 

0271 

PADDL2 

0273 

PADDL4 

0275 

PA DDL, 6 

0277 


7 6 5 4 3 

0 L.Ö j_0 


3 2 1 


Pins S 


7 

6 

5 

4 

3 

2 

i 

0 

E 

0 

0 

0 

X 

TT 

n 

El 


Function Tables 


Jac k 

1, 

pins 4,3,2, 

if 10053,7 

Jac k 

2, 

Pins 4, 3, 2, 1 

Jac k 

3, 

Pins 4, 3, 2, 1 

Jack 

4, 

Pins 4, 3, 2, 1 

Jack 

1, 

Pin 6 

Jack 

2, 

Pin 

Jack 

3, 

P in 6 

Jac k 

4, 

Pin 6 

Jack 

1, 

Pin 5 

Jac k 

2, 

Pin 5 

Jack 

3, 

Pin 5 

Jack 

4, 

Pin 5 

Jack 

1, 

Pin 9 

Jack 

2, 

Pin 9 

Jac k 

3, 

Pin 9 

Jack 

4, 

Pin 9 

/O Ports: Pin 

1er 

circuitry 

igh 

(or 

floating) 

n is 

pulled low. 
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Appendix A — CIO COMMAND BYTE VALUES 


The following hex values are knoun to be legitimate CIO commands. 
Most handlers: 

03 — OPEN 

05 -- GET RECORD 

07 — GET CHARACTERS 

09 — PUT RECORD 

OB — PUT CHARACTERS 

OC — CLÖSE 

OD — GET STATUS 

Display Händler onlg: 

11 — FILL 

12 — DRAW 

Diskette File Manager only: 

20 — RENAME 

21 — DELETE 

22 — FORMAT 

23 — LOCK 

24 — UNLOCK 

25 — POINT 

26 — NOTE 
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Appendix B 


Shoun below 
01 ( 001 > — 

80 (128) — 

81 (129) — 

82 (130) — 

83 (131) — 

84 (132) — 

85 (133) — 

86 (134) — 

87 (135) — 

88 (136) — 

89 (137) — 
8A (138) — 
QB (139) -- 
8C (140) — 
SD (141) — 
SE (142) — 
8F (143) — 

90 (144) — 

91 (145) — 

92 <146) — 

93 (147) — 

AO (160) — 
Al (161) — 
A2 (162) — 
A3 (163) — 
A4 (164) — 
A5 (165) — 
A6 (166) — 
A7 (167) — 
A8 (168) — 
A9 (169) -- 
AA (170) — 
AB (171) — 


- CIO STATUS BYTE VALUES 


are the knoum CIO STATUS BYTE values. 

OPERATION CQMPLETE (NO ERRORS) 

£BREAK3 KEY ABORT 

IOCB ALREADY IN USE (OPEN) 

NON-EXISTENT DEVICE 

OPENED FOR WRITE ONLY 

INVALID COMMAND 

DEVICE OR FILE NOT OPEN 

INVALID IOCB NUMBER (Y reg only) 

OPENED FOR READ ONLY 

END OF FILE 

TRUNCATED RECORD 

DEVICE TIMEOUT (DOESN'T RESPOND) 
DEVICE NAK 

SERIAL BUS INPUT FRAMING ERROR 

CURSOR out-of-range 

SERIAL BUS DATA FRAME OVERRUN ERROR 

SERIAL BUS DATA FRAME CHECKSUM ERROR 

DEVICE DONE ERROR 

BAD SCREEN MODE 

FUNCTION NOT SUPPORTED BY HÄNDLER 
INSUFFICIENT MEMORY FOR SCREEN MODE 

DISK DRIVE # ERROR 
TOO MANY OPEN DISK FILES 
DISK FULL 

FATAL DISK I/O ERROR 
INTERNAL FILE # MISMATCH 
FILE NAME ERROR 
POINT DATA LENGTH ERROR 
FILE LOCKED 

COMMAND INVALID FOR DISK 
DIRECTORY FULL (64 FILES) 

FILE NOT FOUND 
POINT INVALID 
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Appendix C — SIQ STATUS BYTE VALUES 


Shotun belout 

01 ( 001 ) — 

8A (138) — 
8B (139) — 
8C (140) — 
8E (142) — 
8F (143) ~ 
90 (144) — 


are the knoun SIO STATUS BYTE hexadecimal value 

OPERATION COMPLETE (NO ERRORS) 

DEVICE TIMEOUT (DOESN'T RESPOND) 

DEVICE NAK 

SERIAL BUS INPUT FRAMING ERROR 
SERIAL BUS DATA FRAME OVERRUN ERROR 
SERIAL BUS DATA FRAME CHECKSUM ERROR 
DEVICE DONE ERROR 
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Appendix D — ATASCII CODES 



0X 

2X 

4X 

6X 

8X 

AX 

CX 

EX 

00 

□ 

Spa et; 

@ 

□ 





01 

O 

1 

A 

a 





02 

n 

II 

B 

b 





03 

Q 

# 

C 

c 





04 

Q 

$ 

D 

d 





05 

O 

% 

E 

e 





06 

Q 

Sc 

F 

f' 





07 

SS 

1 

G 

g 





08 

e 

( 

H 

h 





09 

r 

) 

I 

i 





0K 

B 

* 

J 

j 





0B 

G 

+ 

K 

k 





0C 

a 

/ 

L 

1 





0D 

B 

- 

M 

m 





0E 

B 

* 

N 

n 





0F 

B 

/ 

0 

o 





10 

B 

0 

P 

P 





11 

B 

1 

Q 

q 





12 

D 

2 

R 

r 





13 

a 

3 

S 

s 





14 

□ 

4 

T 

t 





15 

b 

5 

U 

u 





16 

9 

6 

V 

V 





17 

B 

7 

W 

w 





18 

B 

8 

X 

X 





19 

a 

9 

Y 

y 





1A 

Q 

• 

■ 

Z 

z 





1B 

ESC 

• 

t 

c 

B 

EOL 




IC 

0 

< 

\ 

1 

E5&E 




ID 

0 

m 

1 

CLEAR 

£?§E 



BELL 

IE 

a 

:> 

/\ 

BACKSP 

m 



e&R 

1F 

a 

? 


TAB 

m 



m r 


QPERATING SYSTEM CÖ16555 — Appendix D 


183 


Appendix E — DISPLAY CODES (ATASCII) 
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Appendix F — KEYBOARD CODES (ATASCII) 


CTRL SHIFT & 

LOWER 


00 

t 

20 

20 

<space> 

21 

01 

A 

3F 

21 

I 

1F 

02 

B 

15 

22 

fl 

iE 

03 

C 

12 

23 

# 

1A 

04 

D 

3A 

24 

% 

18 

05 

E 

2A 

25 

X 

ID 

06 

F 

38 

26 

h. 

1B 

07 

G 

3D 

27 

t 

33 

08 

H 

39 

28 

( 

30 

09 

I 

OD 

29 

) 

32 

OA 

J 

01 

2A 

* 

07 

OB 

K 

05 

2B 

+ 

06 

OC 

L 

00 

2C 

f 

20 

OD 

M 

25 

2D 

- 

OE 

OE 

N 

23 

2E 


22 

OF 

0 

08 

2F 

/ 

26 

10 

P 

OA 

30 

0 

32 

11 

ö 

2F 

31 

1 

1F 

12 

R 

28 

32 

2 

IE 

13 

S 

3E 

33 

3 

1A 

14 

T 

2D 

34 

4 

IS 

15 

U 

OB 

35 

5 

ID 

16 

V 

10 

36 

6 

1B 

17 

W 

2E 

37 

7 

33 

18 

X 

16 

38 

8 

35 

19 

Y 

2B 

39 

9 

30 

1A 

Z 

17 

3A 


02 

1B 

<esc> 

IC 

3B 

i 

OD 

IC 

A <up> 

OE 

3C 

< 

36 

ID 

A <doüm> 

OF 

3D 

= 

OF 

IE 

''-■Clef t> 

06 

3E 

> 

37 

1F 

''■•Cright>07 

3F 

? 

26 

80- 

-9A /! \ 

00- 

1A 



9B 

<return> and 

A 3 

OC, 1A 


9C 

s<del> 

34 




9D 

s-Cinsert>37 




9E 

^<tab> 

2C 





SHIFT LOWER 


40 

@ 

35 

60 

A 

22 

41 

A 

3F 

61 

a 

3F 

42 

B 

15 

62 

b 

15 

43 

C 

12 

63 

c 

12 

44 

D 

3A 

64 

d 

3A 

45 

E 

2A 

65 

e 

2A 

46 

F 

38 

66 


38 

47 

G 

3D 

67 

9 

3D 

48 

H 

39 

68 

h 

39 

49 

I 

OD 

69 

i 

OD 

4A 

J 

01 

6A 

J 

01 

4B 

K 

05 

6B 

k 

05 

4C 

L 

00 

6C 

1 

00 

4D 

M 

25 

6D 

m 

25 

4E 

N 

23 

6E 

n 

23 

4F 

0 

08 

6F 

0 

08 

50 

P 

OA 

70 

P 

OA 

51 

Q 

2F 

71 

4 

2F 

52 

R 

28 

72 

r 

28 

53 

S 

3E 

73 

s 

3E 

54 

T 

2D 

74 

t 

2D 

55 

U 

OB 

75 

u 

OB 

56 

V 

10 

76 

V 

10 

57 

w 

2E 

77 

w 

2E 

58 

X 

16 

78 

X 

16 

59 

Y 

2B 

79 

y 

2B 

5A 

Z 

17 

7A 

z 

17 

5B 

t 

20 

7B 

f 

02 

5C 

\ 

06 

7C 

t 

f 

OF 

5D 

1 

22 

7D 

<clear> 

36 

5E 

A 

07 

7E 

<back> 

34 

5F 


OE 

7F 

<tab> 

2C 


9F 

s<tab> 

2C 

AO- 

-FC / S \ 

20-7C 

FD 

A 2 

IE 

FE 

A <del> 

34 

FF 

''■<insert>37 


<clear> ::= s< or 

<return> ::= <return> or s<return> or A <return> 

<esc> ::= <esc> or s<esc> or A <esc> 

<space> <space> or s<space> or A <space> 

Where: s as a prefix indicates CSHIFT3. 

as a pref i x indicates CCTRL3- 
/i\ as a prefix indicates ATARI key inverse active. 
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Appendix G 


PRINTER CODES (ATASCII) 

Character 

set 

f or 

"normal 

" mode printing 

20 

<space> 

40 

® 

60 

\ 

21 

i 

41 

A 

61 

a 

22 

» 

42 

5 

62 

b 

23 

# 

43 

C 

63 

c 

24 

$ 

44 

D 

64 

d 

25 

X 

45 

E 

65 

e 

26 

& 

46 

F 

66 

f 

27 


47 

G 

67 

9 

28 

( 

48 

H 

68 

h 

29 

> 

49 

I 

69 

i 

2A 

* 

4A 

J 

6A 

J 

2B 

+ 

4B 

K 

6B 

k 

2C 


40 

L 

60 

1 

2D 

- 

4D 

M 

6D 

m 

2E 


4E 

N 

6E 

n 

2F 

/ 

4F 

0 

6F 

0 

30 

0 

50 

P 

70 

P 

31 

1 

51 

G 

71 

4 

32 

2 

52 

R 

72 

r 

33 

3 

53 

S 

73 

s 

34 

4 

54 

T 

74 

t 

35 

5 

55 

U 

75 

u 

36 

6 

56 

V 

76 

V 

37 

7 

57 

u 

77 

ui 

38 

8 

58 

X 

78 

X 

39 

9 

59 

Y 

79 

y 

3A 


5A 

z 

7A 

z 

3B 

1 

55 

L 

7B 

< 

30 

< 

50 

\ 

70 

1 

1 

3D 

= 

5D 

1 

7D 

> 

3E 

> 

5E 

A 

7E 


3F 

7 

5F 


yp 

<space> 


Note: The following Codes print d i f f erent 1 y than defined by 
the ATASCII definition. 

00 through 1F print blank. 

60 prints ' instead of "diamond“. 

7B prints •£ instead of "spade". 

7D prints > instead of "clear". 

7E prints ^ instead of “backspace“. 

7F prints blank instead of "tab". 
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Character 

set 

for “ 

sideways“ mod 



40 

@ 

60 

@ 



41 

A 

61 

A 



42 

B 

62 

B 



43 

C 

63 

C 



44 

D 

64 

D 



45 

E 

65 

E 



46 

F 

66 

F 



47 

G 

67 

G 



48 

H 

68 

H 



49 

I 

69 

I 



4A 

J 

6A 

J 



4B 

K 

6B 

K 



4C 

L 

60 

L 



4D 

M 

6D 

M 



4E 

N 

6E 

N 



4F 

□ 

6F 

0 

30 

0 

50 

P 

70 

P 

31 

1 

51 

0 

71 

Q 

32 

2 

52 

R 

72 

R 

33 

3 

53 

S 

73 

S 

34 

4 

54 

T 

74 

T 

35 

5 

55 

ü 

75 

U 

36 

6 

56 

V 

76 

V 

37 

7 

57 

w 

77 

W 

38 

8 

58 

X 

78 

X 

39 

9 

59 

Y 

79 

Y 

3A 


5A 

Z 

7A 

z 

3B 

i 

5B 

C 

7B 

c 

3C 

< 

5C 

\ 

70 

\ 

3D 

= 

5D 

3 

7D 

1 

3E 

> 

5E 

<up> 

7E 

<up> 

3F 

? 

5F 

7F 

<left> 


Note: the following codes print differently than defined by 
the ATASCII definition. 


00 

through 

2F 

print b 

lank. 

5E 

prints 1 

•up 

arroui'* 

instead of 

5F 

prints ' 

"left arroui 

" instead of 

60 

througb 

7F 

repeats 

40 througb 5F instead of proper set 


OPERATING SYSTEM 0016555 — Appendix G 


187 



Appendix H 


SCREEN MODE CHARACTERISTICS 


Mode 

Hori z. 

Vert. 

Vert. 

Colors 

Data 

Color 

Memory 


# 

Posi t. 

W/0 Sp 

W Sp 


Va 1 ue 

Reg. 

Reqd. 

( sp I i t) 

(füll > 

0 

40 

24 

— 

2 

bac kgd. 

BAK 


992 






OO-FF 

PF 2 








fl 

PF 1* 



1< 

20 

24 

20 

5 

bac kgd. 

BAK 

674 

672 






Q0-3F 

PF 0 








4G-7F 

PF 1 








SO-BF 

PF 2 








CO-FF 

PF 3 



2 

20 

12 

10 

0 

backgd. 

BAK 

424 

420 






00-3F 

PF 0 








40-7F 

PF 1 








80-BF 

PF 2 








CO-FF 

PF 3 



3 

40 

24 

20 

4 

0 

BAK 

434 

432 






1 

PF 0 








2 

PF 1 








3 

PF 2 



4 

80 

48 

40 

2 

0 

BAK 

694 

696 






I 

PF 0 



$ 

80 

48 

40 

4 

0 

BAK 

1174 

1176 






1 

PF 0 








2 

PF 1 








3 

PF 2 



6 

160 

96 

80 

2 

0 

BAK 

2174 

2184 






1 

PF 0 



7 

160 

96 

80 

4 

0 

BAK 

4190 

4200 






1 

PF 0 








2 

PF 1 








3 

PF 2 



8 

320 

192 

160 

2 

0 

p p ^ 

8112 

8138 






1 

PF 1'* 



9 

SO 

192 


1 

Note 2 



8138 

10 

80 

192 


9 

0 

PM 0 


8138 






1 

PM 1 








2 

PM 2 








3 

PM 3 








4 

PF 0 




OPERATING SYSTEM CÖ16555 — Appendix H 


188 


5 PF 1 

6 PF 2 

7 PF 3 

8 BAK 

9 BAK 

A BAK 

B BAK 

C PF O 

D PF 1 

E PF 2 

F PF 3 

11 80 192 -- 16 Note 3 8138 


Notes: 

* Uses color of PF 2« lum of PF 1. 

2 Uses color of BAK# lum of data value (*0-F>. 

3 Uses color of data value (4Q-F)# lum of BAK. 

PF x Playfield color register x. 

PM x Player/Missile Graphics color register x. 

BAK :;— Background color register (also knoum as PF 4>. 

The default values for the color registers are shoum belauf: 


BAK 

— 

*00 

PFO 

= 

*28 

PF1 

= 

*CA 

PF2 

= 

*94 

PF3 

SS 

*46 
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The form of a color register byte is shouin below; 


Where: 


76543210 
+-+~+-+-+-+-+-+-+ 
i color ! lum !0i 


color (hex values) lum 

0 = gray O = 

1 = light orange I = 

2 = orange 2 = 

3 — red orange 3 = 

4 = pink 4 = 

5 * purple 5 « 

6 » purple-blue 6 = 

7 = blue 7 = 


8 = blue 

9 = light blue 
A = turquoise 
B = green-blue 
C * green 

D = ye1low-green 
E — orange-green 
F = light orange 


minimum luminance 


tinereasing 
1uminance> 

1 

i 

I 

maximum luminance 
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Appendix I 


SERIAL BUS ID AND CQMMAND SUMMARY 


Serial bus device IDs 

Floppy diskettes D1-D4 $31-34 

Printer PI $40 

RS-232-C R1-R4 $50-53 


Serial bus control Codes 


ACK 

NAK 

COMPLETE 

ERR 


$41 ('A') 
$4E t'N'l 
$43 ( 'C ' : 
$45 <'E' > 


Serial bus command Codes 


READ 

«RITE 

STATUS 

PUT(no check) 
FORMAT 

READ ADDRESS 
READ SPIN 
MOTOR ON 
VERIFY SECTOR 


- $52 i 'R'> 

- $57 { 'WM 

- $53 ('S') 

- $50 ('P') 

- $21 i ' l ') 

- $54 { 'T'> 

- $51 C 'QM 

- $55 [ 'UM 

- $56 ( 'VM 


Disk 

Printer/Disk 

Printer/Disk 

Disk 

Disk 

Disk 

Disk 

Disk 
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Appendix J 

— ROM 

VECTORS 


The fixed 

address 

OS 

ROM JMP 

vectors are shoum beloui; at each 

address is 

a JMP 

instruction 

to the indicated routine. 

Name 

Addr 

Reference 

Function 

DISKIV 

E450 



Diskette Hand 1er initialization 

DSKINV 

E453 

5. 

4. 2 

Diskette Hand 1er entry. 

CIOV 

E456 

5. 

2 

CIO utility entry. 

SIOV 

E459 

9. 

3 

SIO utility entry. 

SETVBV 

E45C 

6. 

7. 2 

Set System Timers routine. 

SYSVBV 

E45F 

6 . 

3 

Stage 1 VBLANK entry. 

XITVBV 

E462 

6 . 

3 

Exit VBLANK entry. 

SIOINV 

E465 

# 


SIO utility initialization. 

SENDEV 

E4&8 

* 


Send enable routine. 

INTINV 

E4&B 

* 


Interrupt Händler initia1ization 

ciöinv 

E46E 

«• 


CIO utility initialization. 

BLKBDV 

E471 

3. 

1 . 1 

Blackboard mode entry. 

WARMSV 

E474 

7. 


Warmstart (C SYSTEM. RESET3) entry 

COLDSV 

E477 

7. 


Coldstart (potuer-upJ entry. 

RBLOKV 

E47A 



Cassette-read block entry. 

CSQPIV 

E47D 

* 


Cassette-OPEN input entry. 


* These vectors are for QS internal use only. 


The fixed address Floating Point Package ROM routine entry point 
addresses are shoun faelouj; complete descriptions of the 
corresponding routines are provided in Section 8. 


AFP 

D800 

ASCII to FP convert. 

FASC 

D8E6 

FP to ASCII convert. 

IFP 

D9AA 

Integer to FP convert. 

FPI 

D9D2 

FP to integer convert. 

FADD 

DA66 

FP add. 

FSUB 

DAAO 

FP subtract. 

FMUL 

DADB 

FP mu1tip1y 

FD IV 

DE 28 

FP divide. 

LOG 

DECD 

FP base e logarithm. 

LOG 10 

DED1 

FP base 10 logarithm. 

EXP 

DDCO 

FP base e exponentiation. 

EXP 10 

DDCC 

FP base 10 exponentiation. 

PLYEVL 

DD40 

FP polynomial evaluation. 

ZFRÖ 

DA44 

Clear FRO. 

ZF1 

DA46 

Clear FP number. 

FLDOR 

DD89 

Load FP number. 

FLDOP 

DD8D 

Load FP number. 

FLD1R 

DD98 

Load FP number. 

FLD1P 

DD9C 

Load FP number. 

FSTOR 

DDA7 

Store FP number. 

FSTOP 

DDAB 

Store FP number. 

FMOVE 
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DDB6 

Move FP number. 
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The base addresses of the Händler vectors for the resident 
handlers are shown below: 


Screen Editor <E> E400 
Display Händler <S) E410 
Keyboard Händler <K) E420 
Printer Händler (P) E430 
Cassette Händler (C) E440 


See Section 5 for the format of the entry -for each Händler. 
The 6502 Computer interrupt veetor values are shoum below: 


Function 

Address 

Value 

NMI 

FFFA 

E7B4 

RESET 

FFAC 

E477 

IRQ 

FFFE 

E6FE 
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Appendix K — DEVICE CHARACTERISTICS 


This appendix describes the physical characteristics of the 
devices that interface to the ATARI 400 and ATARI 800 Home 
Computers. Where applicable, data capacity. data transfe? 
rate, storage -Format. SIO int er Face, and cabling will be 
detailed. 


KEYBOARD 

The keyboard input rate is limited by the OS keyboard reading 
procedure to be 60 characters per second. The code for each key 
is shown in Table 5-4. The keyboard hardware has no buffering and is 
rate-limited by the debounce algorithm used. 


DISPLAY 

The television screen display generator has many capabilities 
that are not used by the Display Händler (as described in Section 
5 and shown in Appendix H). There are additional display modes. 
object generators. hardtuare display Scrolling, and many other 
features that are described in the ATARI Home Computer 
Hardware Manual. 

Since all display data is stored in RAM. the display data update 
rate is limited primarily by the Software routines that generate 
and formet the data and access the RAM. The generation of the 
display from the RAM is accomplished by the ANTIC and CTIA or GTIA 
chips using Direct Memory Access (DMA> to access the RAM data. 

The internal storage Formats For display data For the various 
modes are detailed in the ATARI Home Computer Hardware 
Manual. 


ATARI 410 PROGRAM RECORDER 

The ATARI 410 Program Recorder has the following characteristics: 
DATA CAPACITY: 

iöö characters per C-60 tape (unformatted>. 

DATA TRANSFER RATES: 

* 600 Baud (60 characters per second) 

»Note: The OS has the ability to adjust to different tape speeds 
(447 - 895 Baud >. 
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STORAGE FORMAT: 


Tapes are recorded in 1/4 track stereo format at 1 7/8 inches per 
sec and. The tap e can be recorded in faoth directionsi uthere trac ks 
1 and 2 are side A left and right; and tracks 3 and 4 are side B 
right and left (industry Standard). On each side* the left 
channel (1 or 4) is used f or audio and the right channe1 <2 and 
3) is used for digital Information. 

The audio channel is recorded the normal tuay, The digital channel 
is recorded using the POKEY tuio—tone mode producing FSK data at 
up to 600 baud. The MARK frequency is 5327 Hz and the SPACE 
frequency is 3995 Hz. The transmission of data is asynchronous 
byte serial as seen from the computer; POKEY reads or ttrrites a 
bit serial FSK sequence for each byte* in the following Order: 


1 start bit (SPACE) 
data bit 0 -+ 
data bit 1 f 

+- 0 = SPACE* 1 « MARK, 

data bit 6 ! 

data bit 7 -+ 

1 stop bit (MARK) 

The only control the Computer has over tape motion is motor 
start/stop; and this only if the PLAY button is pressed by the 
user. In order for recording to take place* the user must press 
both the REC and PLAY buttons on the cassette. The Computer has 
no uiay to sense the position of these buttons* nor even if an 
ATARI 410 Program Recorder is cabled to the Computer* so the user must 
be careful tuhen using this device. 


SIO INTERFACE 

The cassette device utilizes portions of the serial bus harduiare* 
but does not follotu any of the protocol as defined in Section 9. 


ATARI 820CTM3 40-CQLUMN IMPACT PRINTER 

The ATARI 820 Printer has the follotifing characteristics: 


DATA CAPACITY: 

40 characters per line (normal printing) 

29 characters per line (sideways printing) 


DATA TRANSFER RATES: 
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Bus -rate: xx characters per second. 

Print time (bürst): xx characters per second. 
Print time (average): xx characters per second. 


STÜRAGE FORMAT: 

3 7/8 inch uride paper. 

5X7 dot matrix ( impact printing. 


Normal format — 

40 characters per line. 

6 lines per inch (vertica 1). 

12 characters per inch (horizontal). 


Sideutays Format — 

29 characters per line. 

6 lines per inch (vertical). 

9 characters per inch (horizontal). 


SIQ INTERFACE 

The Controller serial bus ID is $40. 

The Controller Supports the following SIQ commands (see Section 5 
for rnore Information regarding the Händler and Section 9 for a 
general discussion of bus commands): 


GET STATUS 

The Computer sends a command frame of the format shoum belauf: 

Device ID = $40. 

Command byte = $53. 
auxiliary 1 = doesn't matter, 
auxi1iary 2 = doesn't matter, 

Checksum = checksum of bytes above. 

The printer Controller responds with a data fTame of the Format 
shoum earlier in this appendix as part of the GET STATUS 
discussion. 


PRINT LINE 

The Computer sends a command frame of the Format shoum belauf: 

Device ID = $40. 

Command byte = $57. 
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auxiliary 1 = doesn't matter. 

auxiliary 2 = $4£ for normal print or $53 for sidetuays. 
Checksum = checksum of bytes above. 

The Computer sends a data frame of the format shown below: 

Leftmost character of line (column 1>. 

Next character of line (column 2). 


Rightmost character of line (column 40 or 29). 

Checksum byte. 

Note that the data frame size is variable, either 41 or 30 bytes 
in length, depending upon the print mode specified in the command 
frame. 


ATARI 810 DISK DRIVE 

The ATARI 810CTM3 Disk Drive has the follouing characteristics: 

DATA CAPACITY: 

720 sectors of 128 bytes each (Disk Händler format). 

709 sectors of 125 data bytes each (Disk File Manager format). 

DATA TRANSFER RATES: 

Bus rate: 1920 characters per second. 

Seek time: 5.25 msec, per track + 10 to 210 msec. 

Rotational latency: 104 msec maximum <288 rpm). 


STÖRAGE FORMAT: 

5 1/4 inch diskette, soft sectored by the Controller. 

40 tracks per diskette. 

18 sectors per track. 

128 bytes per sector. 

Controlled by National INS1771-1 formatter/controller Chip. 
Sector seq.uence per track is: 18, 1, 3, 5, 7, 9, 11, 13, 15, 

17, 2, 4, 6, 8, 10, 12, 14, 16 


SIÜ INTERFACE 

The Controller serial bus IDs ränge from $31 (for 'Dl') to $34 
(for 'D4'). 
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The Controller Supports the following SIO commands (see earlier 
in this Appendix f or Information ahout the Diskette Hand 1er and 
Section 9 for a general discussion of bus commands): 


GET STATUS 

The computer sends a command frame of the format sh own heiou: 

Device ID = *31-34. 

Command byte = *53. 
auxiliary 1 = doesn't matter, 
auxiIiary 2 — doesn't matter. 

Checksum = checksuni of bytes above. 

The diskette Controller responds with a data frame of the format 
shouin earlier in this Appendix as part of the STATUS REQUEST 
d i sc uss ion. 


PUT SECTOR (WITH VERIFY) 


The Computer sends a command frame of the format shown below: 

Device ID * *31-34 
Command by te = *57. 

auxiliary 1 = low byte of sector number. 
auxiliary 2 = high byte of sector number (1-720). 

Checksum = checksum of bytes above. 

The Computer sends a data frame of the format shown below: 


128 data bytes. 
Checksum byte. 


The diskette 
sector/ then 
frame data. 
Operation. 


Controller uirites the frame data to the specified 
reads the sector and compares the content with the 
The COMPLETE byte value indicates the status of the 


PUT SECTOR (NO VERIFY) 

The Computer sends a command frame of the format shown below: 

Device ID = *31-34 
Command byte = *50. 

aux i 1 iary 1 = 1 oui byte of sector number. 
auxiliary 2 = high byte of sector number (1-720). 

Checksum = checksum of bytes above. 

The Computer sends a data frame of the format shown below: 
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128 data bytes. 

Checksum byte. 

The disfcette Controller writes the -Frame data to the speeiFied 
sector t then sends a CQMPLETE byte value that indicates the 
Status of the operation. 


GET SECTOR 

The Computer sends a command Frame oF the Format shouin below: 

Device ID = *31-34 
Command byte = $52. 

au* i 1 iary 1 = 1 ow byte oF sector n umber. 
auxiliary 2 = high byte oF sector number (1-720). 

Checksum = checksum oF bytes above. 

The diskette Controller sends a data Frame oF the Format shotim below: 

128 data bytes. 

Checksum byte. 


FORMAT DISKETTE 

The Computer sends a command Frame of the Format shown beiow: 

Device ID = *31-34 
Command byte = *21. 
auxiliary 1 = doesn't matter, 
auxiliary 2 = doesn't matter. 

Checksum = c hec ksum of bytes above. 

The diskette Controller completely Formats the diskette (generates 40 
tracks oF 18 soFt sectors per track with the data portion oF each 
sector eq.ua! to all zeros) and then reads each sector to veriFy 
its integrity. A data Frame oF 128 bytes plus checksum is 
returned in that the sector numbers oF all bad sectors (up to a 
maximum oF A3 sectors) are contained t Followed by two consecutive 
bytes oF *FF. IF there are no bad sectors on the diskette the First 
2 bytes oF the data 
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Appendix L — QS DATA BASE VARIABLE FUNCTIONAL DESCRIFTIONS 
CENTRAL DATA BASE DESCRIPTIGN 


This appendix provides detailad inFormation for those variab1 es 
in the OS data base that can be altered by the user. Remaining 
variab1 es are provided narrative descriptions. Information on the 
var iab les is presen ted in a mul tiple access scheine: Lao k up 
tables are referenced ta a common set of narratives* that is 
itself ordered by function. 

Variable descriptions are referenced by a label called a variable 
identifier (VID) number. The label comprises a single letter 
follotued by a number. A different letter is assigned for each 
major functional area being described, and the numbers are 
assigned sequentially within each functional area. Those 
variables that are not considered to be of interest to any user 
are flagged mith an asterisk C*) after their names. The data base 
lookup tables provided are: 

1. Functional grouping — index to the function narrative and 
descriptions of variables* giving VID and variable name. 

2. Alphabetic list of names — giving VID of description. 

3. Address ordered list — giving VID of description. 

Item 1 * the func tional grouping index* starts on the next page; 
the other two lookup tables are at the end of Appendix L. 
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FUNCTIÜNAL INDEX TO DATA BASE VARIABLE DESCRIPTIGNS 


A. Memory configuration 
Al MEMLO 
A2 MEMTGP 
A3 APPMHI 
A4 RAMTOP 
A5 RAMSIZ 


B. Text/graphics screen 

Cursor control 
Bl CRSINH 
B2 ROWCRSiCOLGRS 
B3 OLDROWfOLDCOL 
B4 TXTROW/TXTCOL 


Screen margins 
B5 LMARGN 
B6 RMARGN 


Color control 

B7 PCOLRO - PCGLR3 
B8 CQLORÖ - C0L0R4 

Text scrolling 
B9 SCRFLG# 


Attract mode 
BIO ATRACT 
Bll CGLRSH* 

B12 DRKMSK* 

Tabbing 

B13 TABMAP 

Logical text lines 
B14 LOOMAP* 

BIS LOGCOL* 

Split screen 
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B16 BOTSCR* 


FILL/DRAW function 
B17 FILDAT 
BIS FILFLG* 

B19 NEW 5R0W*,NEWCOL* 
B20 HOLD4* 


B2t RQWINC** CQLINC* 

B22 DELTAR*, DELTAC* 

B23 COUNTR* 

B24 ROWAC*,CÖLAC* 

B25 ENDPT* 

Displaying control characters 

Escape < display following control char> 
B2& ESCFLG* 


Display control characters mode 
B27 DSPFLG 

Bit mapped graphics 
B28 DMASK* 

B29 SHFAMT* 
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Interna I tuor k ing variab les 
B30 H0LD1* 

B31 H0LD2* 

B32 H0LD3* 

B33 TMPCHR* 

B34 DSTAT* 

835 DINDEX 
336 SAVMSC 
B37 OLDCHR* 

B38 OLDADR* 

B39 ADRESS* 

B40 MLTTMP/OPNTMP/TOADR* 
B41 SAVADR/FRMADR* 

B42 BUFCNT* 

B43 BUFSTR* 

B44 SWPFLG* 

B45 INSDAT* 

B46 TMPROW*,TMPCQL* 

B47 TMPLBT* 

B48 SUBTMP* 

B49 TINDEX* 

B50 BITMSK* 

B51 LINBUF* 

B52 TXTMSC 
B53 TXTOLD* 
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Internal character code conversion 
E54 ATACHR 
B55 CHAR* 


C. Disk Händler 
CI BUFADR* 
CS DSKTIM* 


D. Cassette (parfc in SIÜ part in Händler) 

Baud rate determination 
Dl CBAUDL** CBAUDH* 

D2 TIMFLG* 

D3 TIMER1*# TIMER2* 

D4 ADDCOR* 

D5 TEMPI* 

D6 TEMP3* 

D7 SAVIQ* 

Cassette mode 
D8 CASFLG* 

Cassette buffer 
D9 CASBUF* 

DIO BLIM* 

DU BPTR* 

Internal working variables 
Dl2 FEÜF* 

Dl3 FTYPE* 

Dl4 WMODE* 

Dl 5 FREG* 


E. Kegboard 

Keg reading and debouncing 
El CHI* 

E2 KEYDEL* 

E3 CH 
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Special functions 

Start/stop 
E4 SSFLAG 

c break: 

ES BRKKEY 

ESHIFT3/CCONTROL3 lock 
E6 SHFLQK 
E7 HOLDCH* 

Autorepeat 
ES SRTIMR* 

Inverse Video 
E9 INVFLG 

Console switches (CSELECT3»CSTART3 ( and 


F. Printer 

printer-buffer 

Fl PRNBUF* 

F2 PBUFSZ* 

F3 PBPNT* 

Internal working variables 
F4 PTEMP# 

F5 PTIMOT* 


G. Central I/O routine (CIO) 
User call parameters 

Gl IOCB 
G2 ICHID 
G3 ICDNO 
G4 ICCOM 
G5 ICSTA 
G6 ICBALiICBAH 
G7 ICPTLtICPTH 
G8 ICBLL.ICBLH 
G? ICAX1 i ICAX2 
GIO ICSPR 

Device Status 
Gil DVSTAT 

device table 
G12 HATABS 


[OPTION]> 
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CIG/Handler interface Parameters 


G13 ZIOCB (IOCBAS) 

G14 ICHIDZ 

G15 ICDNQZ 

G16 ICCOMZ 

G17 ICSTAZ 

GIS ICBALZjICBALH 

G19 ICPTLZfICPTHZ 

G30 ICBLLZfICBLHZ 

G31 ICAXlZtICAX3Z 

G32 ICSPRZ (ICIDNO,CIQCHR) 


Internal working variables 
G33 ICCOMT* 

G24 ICIDNO* 

025 CIOCHR* 


H. Serial I/O routine (SIQ) 


User call Parameters 

Hl DCB control block 
H2 DDEVIC 
H3 DUNIT 
H4 DCQMND 
H5 DSTATS 
H6 DBUFLQf DBUFHI 
H7 DTIMLO 
H8 DBYTLOfDBYTHI 
H9 DAUXi> DAUX2 

Bus sound control 
H10 SOUNDR 

Serial bus control 


Retry logic 
Hl1 CRETRY* 
Hl2 DRETRY* 


Chec kaum 

H13 CHKSUH* 
Hl4 CHKSNT* 
Hl5 NOCKSM* 
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Data buffering 


GeneraI buffer control 

H16 BUFRLQ*,BUFRHI* 
H17 BFENLÜ#,BFENHI* 


Command f ratne output buff er 
H18 CDEVIC* 

H19 CCOMND# 

H20 CAUX1*/CAUX2* 

Receive/transdiit data buffering 
H21 BUFRFL* 

H22 RECVDN* 

H23 TEMP* 

H24 XMTDÖN* 

SIO timeout 
H25 TIMFLG* 

H26 CDTMVi* 

H27 CDTIiAi* 

Internal working variables 
H28 STACKP* 

H29 TSTAT# 

H30 ERRFLG# 

H31 STATUS* 

H32 SSKCTL* 


ü, ATARI Controllers 
Joysticks 

J1 STICKO - STICK3 
J2 STR IGO - STRIG3 

Paddies 

J3 PADDLO ~ PADDL7 
J4 PTRIGO - PTRIG7 

Padd le Controllers 
J8 STICKO - STICK3 
J9 STR IGO - STRIG3 


K, Disk file managet 
Kl FMSZPG* 

K2 ZBUFP* 

K3 ZDRVA* 

K4 ZSBA* 

K5 ERRNQ* 
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L. Disk Utilities <DÖS> 
LI DSKUTL* 


M. Floating point package 
Ml FRO 
M2 FRE* 

M3 FR1 
M4 FR2* 

M5 FRX* 

MA EEXP* 

M7 NSIGN* 

MS ESION# 

M9 FCHRFLG* 

MtO DIGRT* 

MÜ CIX 
M12 INBUFF 
Ml3 ZTEMPI* 

M14 ZTEMP4* 

Ml5 ZTEMP3* 

M16 FLPTR 
Ml7 FPTR2* 

M18 LBPR1* 

M19 LBPR2* 

M20 LBUFF 
M21 PLYARG* 

M22 FPSCR/FSCR* 

M23 FPSCRi/FSCRl* 

M24 DEGFLG/RADFLG* 


N, Power-Up and System Reset 
RAM sizing 

NI RAMLO*fTRAMSZ* 

N2 TSTDAT* 


Diskette/cassette-boot 
N3 DOSINI 
N4 CKEY* 

N5 CASSBT* 

N6 CASINI 
N7 BOOT?* 

NS DFLAGS* 

N9 DBSECT* 

NIO BOOTAD* 

Environments 1 contro1 
Nil COLDST 
Ni2 DOSVEC 
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CS RESET3 

Ni3 WÄRMST 


P. Interrupts 
PI CRITIC 
P2 POKMSK 


System Timers 


Real-time clock 
P3 RTCLOK 

System Timer 1 
P4 CDTMV1 
P5 CDTMA1 

System Timer 2 
P6 CDTMV2 
P7 CDTMA2 

System Timers 3-5 

PS CDTMV3.CDTMV4,CDTMV5 
P9 CDTMF3, CDTMF4, CDTMF5 


RAM-interrupt vectors 

NMI—interrupt vectors 
P10 VDSLST 
Pli WBLKI 
Pi2 VV8LKD 


IRQ—interrup t vectors 
P13 VIMIRG 
P14 VPRCED 
P15 VINTER 
P16 VBREAK 
P17 VKEYBD 
P18 VSERIN 
P19 VSEROR 
P20 VSERDC 

P21 VTIMRi,VTIMR2* VTIMR4 

Hardtuare register Updates 
P22 SDMCTL 
P23 SDLSTL,SDLSTH 
P24 GPRIOR 
P25 CHACT 
P26 CHBAS 
P27 PCOLRx,CÖLORx 
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Internal working variable 
P28 INTEMP* 


R. User areas 

RI <unlabeled) 
R2 USAREA 


This appendix contains descriptions of many of the data base 
variables; descriptions are included for all of the user- 
accessible variables and for same of the "internal“ variables as 
well. Those variables that are not considered to be norraally of 
interest to any user are flagged with an asterisk (*> after their 
names; the other variables can be of interest to one or more of 
the fo 1 louiing classes of users: 


o End user. 
o Game developer. 
o Applications programmer. 
o System utility writer. 
o Language processor developer. 
o Device Händler Writer. 


Each variable is specified by its System equate file name 
folloued by its address (in hex) and the number of bytes reserved 
in the data base (in decimal)/ in the follouing form: 

<name> t<address>, <size>3 

For example: 

MEMLO CG2E7, 2] 

Note that most uprd (2 byte) variables are ordsred with the least 
significant byte at the 1 euer address. 
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A. MEMORY CONFIGURATION 

See Section 4 for a general discussion of memory dynamics and 
section 7 for details of System initia1ization. 


Al MEMLO C02E7(23 — User—free memory low address 

contains the address of the first location in the free 
memory region. The value is established by the OS during power-up 
and System reset initia1ization and is never altered by the OS 
thereafter. 


A2 MEMTOP C02E5> 2] — User—free memory high address 

MEMTOP contains the address of the first non—useable memory 
location above the free memory region. The value is established 
by the OS during power-up and System reset initializationi and 
then is re—estab 1 ished whenever the display is opened» based upon 
the requirements of the selected graphics mode. 


A3 APPMHI COOOEf21 — User-free memory screen lower limit 

APPMHI is a user-controlled variable that contains the address 
within the free memory region below which the Display Hand 1 er cannot 
go in setting up a display screen. This variable is 
initialized to zero by the OS at power—up. 


A4 RAMTQP* C0Q6A/13 — Display Händler top of RAM address (MSB) 

RAMTOP permanent 1y retains the RAM top address that was contained 
in TRAMSZ (as described in Nil for the Display Handler's use. The 
value is set up as part of Händler initia1ization. 


A5 RAMSIZ C02E4»13 — Top of RAM address (MSB only) 

RAMSIZ permanently retains the RAM top address that was contained 
in TRAMSZ (as described in Nl>. 
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8. TEXT/GRAPHICS SCREEN 


See Section 5 for a discussion of the text and graphics screens 
and their Händlers. 


Cursor Control 

For the text screen and split-screen text window there is a 
visible Cursor on the screen which shows the Position of the next 
input or output Operation. The Cursor is represented by inversing 
the Video of the character upon which it resides; but the Cursor 
can be mad e invisibler at the user / s option. The graphics screen 
always has an invisible Cursor. 

The Cursor position is sensed by examining data base variables 
and can be moved by altering those same variables; in addition> 
ttfhen using the Screen Editori there are Cursor movement contral 
Codes that can be sent as data (as explained in Section 5). 


Bi CRSINH C02F0ilD — Cursor display inhibit flag 

When CRSINH is zero» all Outputs to the text screen will be 
foilowed by a visible Cursor (inversed character); and when 
CRSINH is non Zero» no visible Cursor will be generated. 

CRSINH is set to zero by power-up, the t SYSTEM. RESET3 or £BREAK3 keys 
or an OPEN command to the Display Händler or Screen Editor. 

Note that altering CRSINH does not cause the visible Cursor to 
change states until the next output to the screen; if an 
immediate change to the Cursor state is desired, without altering 
the screen data* follow the CRSINH change with the output of 
CURSOR UPf CURSOR DOWN; or same other innocuous sequence. 


B2 ROWCRS £0054,13 and COLCRS £0055,23 — Current Cursor 
Position 

ROWCRS and COLCRS define the Cursor location (row and columni 
respectively) for the next data element to be read from or 
written to the main screen segment. When in split—screen mode, 
the variables TXTRGW and TXTCOL define the Cursor for the text 
window at the bottom of the screen as explained in B4 below. 

The row and column numbering start with the value zero, and 
increase in increments of one to the number of rows or co1umns minus 
i; with the upper left corner of the screen being the origin (Giö>. 

ROWCRS is a single—byte variable with a maximum allowab1e value 
of 191 (screen modes 8—11); COLCRS is a 2—by te variable with a 
maximum allowable value of 319 (screen mode 8). 
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B3 ÖLDROW E005Ai 13 and OLDCOL E005B, 23 — Prior Cursor Position 


OLDROW and OLDCOL are updated from ROWCRS and COLCRS before every 
Operation. The variables are used only for the DRAW and FILL 
operations. 


B4 TXTROW E0290 1 13 and TXTCOL E0291.23 — Split-screen text Cursor 
Position 

TXTROW and TXTCOL define the Cursor location (row and columni 
respectively) for the next data element to be read from or 
written to the split-screen text tuindow. 

The row and column numbering start with the value zero> and 
increase in increments of one to 3 and 39» respectively; with the 
upper left corner of the split-screen text uindow being the origin 
( 0 , 0 ). 


Screen Margins 

The text screen and split-screen text ufindow have user-alterable 
left and right margins that define the normal domain of the text 
Cursor. 


B5 LMARGN E0052,13 — Text column left margin 

LMARGN contains the column number <0-39) of the text screen left 
margin; the text Cursor will remain on or to the right of the 
left margin as a result of all operations» unless the Cursor 
column variable is directly updated by the user tsee B2 and B4 
above), The default value for LMARGN is 2 and is established upon 
power-up or System reset. 


B6 RMARGN C0053i13 — Text column right margin 

RMARGN contains the column number (0-39) of the text screen right 
margin; the text Cursor will remain on or to the left of the 
right margin as a result of all operations. unless the Cursor 
column variable is directly updated by the user (see B2 and B4 
above). The default value for RMARGN is 39 and is established 
upon power-up or System reset. 
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Color Control 


As part of the stage 2 VBLANK process (see Section 6>> the values of 
nine data base var iab I es are stored in corresponding har du/a re 
color control registers. The color registers are divided into two 
groups: the player/missile colors and the playfield colors. The 

playfield color registers are utilized by the different screen modes 
as shown in Appendix H. The player/missile color registers are not 
used by the Standard OS. 


B? PCOLRO — PC0LR3 C02C0,43 — Player/missile graphics colors 

Each color variable is stored in the corresponding hardware 
register as shown below: 


PCOLRO E02C03 
PCOLR1 C02C13 
PC0LR2 C02C23 
PC0LR3 C02C33 


CÖLPMO ED0123 
C0LPM1 EDQ133 
C0LPM2 ED0143 
CQLPM3 CDG153 


Each color variable has the format shown below: 
7 6 5 4 3 2 10 
I color ! lum !x! 


See Appendix H for Information regarding the color and luminance 
field values. 


B8 COLORO - COLOR4 C02C5,53 — Playfield colors 

Each color variable is stored in the corresponding hardware 
register as shown below: 


COLORO C02C43 
COLOR1 E02C53 
COLOR2 E02C63 
COLOR3 E02C73 
C0L0R4 E02C83 


COLPFO ED0163 
C0LPF1 EDO!73 
C0LPF2 ED0183 
C0LPF3 ED0193 
COLBK CD01A3 


Each color variable has the format shown below; 
7 6 5 4 3 2 1 0 
I color i lum !x l 


See Appendix H for Information regarding the color and luminance 
field values. 
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Text Scrolling 


The text screen or sp 1 it-screen text uindow "scrolls" upward 
whenever one of the two conditions shown below occurs: 

o A text line at the bottom row of the screen extends past the 
right margin. 

o A text line at the bottom row of the screen is terminated bu 
an EOL. 

Scrolling has the effect of removing the entire logical line that 
starts at the top of the screen and then moving all subsequent 
lines upward to fill in the void. The Cursor will also move 
upward if the logical line deleted exceeds one physicai line. 


B9 SCRFLG* C02BB.13 — Scroll flag 


SCRFLG is a warking variab1e that counts 
lines minus 1 that were deleted from the 
since a logical line ranges in size from 
from 0 to 2, 


the number of physicai 
top of the screen; 

1 to 3» SCRFLG ranges 


Attract Mode 

Attract mode is a mechanism that protects the television screen 
from having patterns "burned into“ the phosphors due to a fixed 
display being left on the screen for extended periods of time. 

When the Computer is left unattended for more than 9 minutes, the 
color intensities are limited to 50 percent of maximum and the 
hues are continually varied every 8.3 seconds. Pressing any 
fceyboard data key will be sufficient to remove the attract mode 
for 9 more minutes. 

As part of the stage 2 VBLANK process« the color registers from 
the data base are sent to the corresponding hardware color 
registers; before they are sent, they undergo the following 
transformation: 

hardware register - database variable XOR COLRSH AND DRKMSK 

Normally COLRSH = $00 and DRKMSK — $FE, thus making the above 
calculation a null Operation; however, once attract mode becomes 
active» COLRSH = the content of RTCLOK+i and DRKMSK = $F6, that 
has the effect of modifying all of the colors and keeping their 
luminance always below the 50 percent leve1. 

Since RTCLQK+1 is incremented every 256/60 of a second and 
since the least significant bit of COLRSH is of no consequence, a 
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color/lum ehange will be effected every 8.3 seconds (513/60) 


BIO ATRACT C004D>13 — Attract mode timer and flag 

ATRACT is the timer (and flag) that Controls the initiation and 
termination of attract mode. Whenever a keyboard key is pressed/ 
the keyboard IRQ Service routine sets ATRACT to zero, thus 
terminating attract mode; the CBREAK3 key logic behaves 
accordingly. As part of the stage 1 VBLANK process, ATRACT is 
incremented every 4 seconds; if the value exceeds 127 (after 9 
minutes without keyboard activity). the value of ATRACT will 
be set to ♦FE and will retain that value until attract mode is 
terminated. 

Since the attract mode is prevented and terminated by the OS 
based only upon keyboard activityi some users can want to reset 
ATRACT based upon Atari-contro1ler event detectioni 
user-controlled Serial I/O bus activity or any other signs of 
life. 


Bll COLRSH* C004F, 13 — Color shift mask 

COLRSH has the value $00 when attract mode is inactive, thus 
effecting no ehange to the screen colors; uhen attract mode is 
active« COLRSH contains the current value of the timer variable 
middle digit (RTCLOK+1). 


B12 DRKMSK* C004E,13 — Dark (luminance) mask 

DRKMSK has the value $FE when attract mode is inactive* wh ic h does not 
alter the luminance; and has the value $F6 when attract mode 
is active* which forces the most significant bit of the luminance 
field to zero; thus guaranteeing that the luminance will never 
exceed 50 percent. 


Tabbing 

See Section 5 for a discussion of the use of tabs in conjunction 
uiith the Screen Editor. 


B13 TABMAP CÖ2A3* 153 — Tab stop setting map 

The tab settings are retained in a 15-byte (120 bit) mapi uihere a 
bit value of 1 indicates a tab setting; the diagram beloui shows 
the mapping of the individual bits to tab positions. 
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Whenever the Display Händler or Screen Editor is openedz this map 
is initialized to contain the value of *01 in every bytez thus 
providing the default tab stops at 7» 15/ 23# etc. 


Logical Text Lines 

The text screen is invisibly divided into logical lines of text/ 
each comprising from one to three physical lines of text. The 
screen is initialized to 24 logical lines of one physical line 
eachi but data entry and/or data insertion can increase the size 
of a logical line to tuo or three physical lines. 


B14 LÜGMAP* C02B2» 43 — Logical line starting row map 

The beginning physical line number for each logical line on the 
screen is retained in a four byte (32 bit) map/ where a bit value 
of one indicates the start of a logical line; the diagram belotu 
shous the mapping of the individual bits to physical line (roui) 
numbers. 
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The map bits are all set to 1 tuhenever the text screen is 
opened or cleared. From that pointz the map is updated as 
logical lines are enteredi edited and deleted from the screen. 
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B15 LQGCOL* £0063, 13 — Cursor/Iogica 1 lins column number 


LOGCQL contains the logical—line column number for the current 
Cursor Position; note that a logical line can comprise up to 
three physical lines. This variable is for the internal use of 
the Display Händler. 


Split Screen 

The Display Händler and Screen Editor together support the 
Operation of a split-screen mode (see Section 5) in tätlich the main 
portion of the screen is in one of the graphics modes and is 
contro11ed by the Display Hand 1er, and there are 4 physical 1ines in 
the text ufindou; at the bottom of the screen which is contro 1 led by th 
Screen Editor, 


B16 BÜTSCR* C02BF,13 — Text screen lines count 

BOTSCR contains the number of lines of text for the current 
screen: 24 for mode 0 or 4 for a split-screen mode. The Händler 
also uses this variable as an indication of the split-screen 
status; tests are made for the specific values 4 and 24. 


DRAW/FILL Function 

The DRAU function line drawing algorithm is shotim belou; 
translated to the PASCAL language from assembly language. 


NEWROW 

:= ROWCRS; NEWCOL := COLCRS; 


DELTAR 
ROMINC 

:= ABS (NEWRÜW-QLDROW); 

5= SIGN (NEWROW-OLDRQW); 

■£ +1 

or -1 

DELTAC 

COLINC 

:= ABS (NEWCOL-QLDCQL >; 

= SIGN (NEWCÜL-OLDCQL >; 

< +1 

or -1 

ROWAC : 
ROWCRS 

= 0; COLAC : = 0; 

:= OLDROW; COLCRS := OLDCOL; 


COUNTR := MAX (DELTAC, DELTAR); 
ENDPT := CQUNTR; 

IF CQUNTR « DELTAC 




THEN RQWAC := ENDPT DIV 2 
ELSE COLAC := ENDPT DIV 2; 


WHILE CQUNTR > 0 DO 
BEGIN 
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ROWAC := ROWAC + DELTAR; 

IF ROWAC >= ENDPT 
THEN 

EEG IN 

ROWAC := ROWAC - ENDPT; 

ROWCRS := ROWCRS + ROWINC 
END; 

COLAC := COLAC + DELTAC; 

IF COLAC >= ENDPT 
THEN 

BEGIN 

COLAC := COLAC - ENDPT; 

COLCRS := COLCRS + COLINC 
END; 

PLQT_POINT; < point defined by ROWCRS and COLCRS > 
IF FILFLG O 0 THEN FILL_LINE; 

COUNTR := COÜNTR - 1 


END; 

The FILL function algorithm (FILLJLINE abovei is described briefly in 
Section 5. 


B17 FILDAT C02FD«13 — Fill data 

FILLDAT contains the fill region data value as part of the calling 
sequence for a FILL command as described in Section 5. 


BIS FILFLG* C02B7,13 — Fill flag 

FILFLG indicates to the shared code tuithin the Display Händler 
whether the current Operation is FILL (FILFLG <> 0) or DRAW 
(FILFLG ■ 0>. 


B19 NEWRQW* 10060«11 and NEWCOL* C0061«23 — Destination point 

NEWROW and NEWCOL are initialized to the values in ROWCRS and 
COLCRS« which represent the destination endpoint of the DRAW/FILL 
command. This is done so that ROWCRS and COLCRS can be altered 
during the performance of the command. 


B20 H0LD4* C02BC.13 — Temporary storage 
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HQLD4 is used to save and restore the value in ATACHR during the 
FILL processi ATACHR is temporarily set to the value in FILDAT to 
accomplish the filling portion of the command- 


B21 ROWINC* E0079, 13 and COLINC* E007A, 13 ~ Row/column 
increment/decrement 

ROWINC and COLINC are the row and column increment values; they 
are each set to +1 or -1 to control the basic direction of line 
drawing. ROWINC and COLINC represent the signs of NEWROW - 
ROWCRS and NEWCOL — COLCRS, respectively, 


B22 DELTAR* E0Q76,13 and DELTAC* E0077,23 — Delta rou and delta 
column 

DELTAR and DELTAC contain the absolute values of NEWROW - ROWCRS 
and NEWCOL - COLCRS» respectively; together with ROWINC and 
COLINC* they define the slope of the 1 ine to be drawn. 


B23 COUNTR* EÖ07E*23 — Drau Iteration count 

COUNTR initially contains the larger of DELTAR and DELTAC* that 
is the number of iterations reyuired to generate the desired 
1ine. COUNTR is then decremented after every point on the line is 
plütted* until it reaches a value of zero. 


B24 ROWAC* E0Q70* 23 and COLAC* E0072,23 — Accumulators 

ROWAC and CÖLAC are working accumulators that control the roui-and 
column-point plotting and increment (or decrement ) function. 


B25 ENDPT* EÖÖ74* 23 —— Line length 

ENDPT contains the langer of DELTAR and DELTAC* and is used in 
conjunction with ROWAC/COLAC and DELTAR/DELTAC to control the 
plotting of line points. 


Displaying Control Characters 

Often it is useful to have ATASCII control codes (such as CLEAR, 
CURSOR UP, etc), displayed in their graphic forms instead of 
having them perform their control function. This display 
capability is provided in two forms when outputting to the Screen 
Editor: 1) a data content form in uhich a special character (ESC) 
precedes each control character to be displayed and 2) a mode 
control form. 
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Escape (Display Following Control Character) 

Whenever an ESC character is detected by the Screen Editor* the 
next character following this code is displayed as data, even if 
it would normally be treated as a control code; the EOL code is 
the sole exception. It is always treated as a control code. The 
sequence ESC ESC will cause the second ESC character to be 
displayed. 


B26 ESCFLG* C02A2. 1 3 — Escape flag 

ESCFLG is used by the Screen Editor to control the escape 
sequence function; the flag is set (to $80) by the detection of 
an ESC character ($1B) in the data stream and is reset (to 0) 
following the output of the next character. 


Display Control Characters Mode 

When it is desired to display ATASCII control codes other than 
EOL in their graphics form, but not have an ESC character 
associated with each control code. a display mode can be 
established by setting a flag in the data base. This capability 
is used by language processors when displaying high-level 
language Statements. that can contain control codes as data 
elements. 


B27 DSPFLG C02FE,13 -- Display control characters flag 

When DSPFLG is nonzero. ATASCII control codes other than EOL are 
treated as data and displayed on the screen when output to the 
Screen Editor. When DSPFLG is lero. ATASCII control codes are 
processed norma1ly. 

DSPFLG is set to zero by Power—up and CSYSTEM. RESET3. 


Bit-Mapped Graphics 

A nuntber of temporary variables are used by the Display Händler 
when handling data elements (pixels) going to or from the screen; 
of interest here are those variables that are used to control the 
packing and unpacking of graphics data, where a memory byte 
typically contains more than one data element (for example. 
screen mode 8 contains 8 pixels per memory byte). 


B28 DMASK* C02A0,13 — Pixel location mask 
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DMASK is a mask that contains zeros for all bits that da not 
correspond to the specific pixel to be operated up om and 
i's for all bits that do correspond. DMASK can contain 
the values shoiun below in binary notation: 

11111111 — screen modes 1 and 2; one pixel per byte. 

llllOOOO screen modes 9—11; two pixels per byte. 

00001111 

11000000 screen modes 3i 5 and 7; four pixels per byte. 

00110000 

00001100 

00000011 

10000000 —— screen modes 4* 6 and 8; eight pixels per byte 

01000000 

00000010 

00000001 


B29 SHFAMT* C0Ö6F»11 — Pixel justification 

SHFAMT indicates the amount to shift the right—justified pixel 
data on outputi or the amount to shift the input data to right 
justify it on input. The value is aluays the same as for DMASK 
prior to the justification process. 


Internal Working Variables 
B30 HGLDl* C0051/13 — Temporary storage 
B31 H0LD2* CÖ29F>13 — Temporary storage 
B32 HQLD3* E029D» 1 3 —— Temporary storage 
B33 TMPCHR* E0050<13 — Temporary storage 
B34 DSTAT* C004C>13 — Display status 
B35 DINDEX C0G57»13 — Display mode 

DINDEX contains the current screen mode obtained from the lou 
order four bits of the most recent OPEN AUX1 byte. 


B36 SAVMSC E0058>23 — Screen Memory Address 

SAVMSC contains the laufest address of the screen data region; the 
data at that address is displayed at the opper left corner of the 
screen. 
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B37 OLDCHR*- C005D,13 — Cursor character save/restore 

OLDCHR retains the value of the charactar under the visibla text 
Cursor; this variable is used to restore the original charactar 
value ufhen the Cursor is moved. 


B38 OLDADR* C005E,23 — Cursor memorg address 

OLDADR retains the memorg address of the current visible text 
Cursor location; this variable is used in conjunction with OLDCHR 
(B37) to restore the original charactar value when the Cursor is 
moved. 


B39 ADRESS* £0064,23 — Temporary storage 

B40 MLTTMP/OPNTMP/TQADR* £0066,23 — Temporary storage 

B41 SAVADR/FRMADR* £0068,23 —— Temporary storage 


B42 BUFCNT* C006B,13 — Screen Editor current logical line size 
B43 BUFSTR* C006C,23 ——Temporary storage 


B44 SWPFLG* C007B,13 — Split-screen Cursor control 

In split-screen mode, the graphics Cursor data and the text 
ttfindow Cursor data are -frequently stuapped as shown belotif in order 
to get the variables associated with the region being accessed 
into the ROWCRS-QLDADR variables. 

RÖWCRS B2 
COLCRS B2 
DINDEX B35 
SAVMSC B36 
OLDRQW B3 
OLDCOL B3 
OLDCHR B37 
OLDADR B38 

SMPFLG is used to keep track of uhat data set is currently in the 
RQWCRS-OLDADR region; SWPFLG is equal to $FF tuhen split-screen 
text uindou Cursor data is in the main region, otherwise SWPFLG 
is equal to 0. 


TXTRQW B4 
TXTCOL B4 
TINDEX 849 
TXTMSC B52 
TXTOLD B53 

II II 

II II 

II II 


B45 INSDAT* C0Q7D,13 — Temporary storage 
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B46 TMPROW# C02B8, 13 and TMPCÜL# CÖ2B9, 23 — Temporary storage 
B47 TMPLBT» CÖ2Ali13 — Temporary storage 
B48 SUBTMP# CÖ29E/13 — Temporary storage 

B49 TINDEX* C0293,13 — Split screen text uindow screen mode 

TINDEX is the split-screen text windoto equivalent of DINDEX and is 
altoay s equal to zero tuhen SWPFLG is equa 1 to zero (see B44). 

B5G BITMSK* E006E,13 Temporary storage 

B51 LINBUF* £0247,403 — Physical line buffer 

LINBUF is used to temporarily buffer one physical line of text 
toben the Screen Editor is moving screen data. 

B52 TXTMSC £0294,23 — Split screen memory address 

TXTMSC is the split-screen text toindoto Version of SAVMSC <B36>. 

See B44 for more information. 

B53 TXTQLD* £0296,63 — Split screen Cursor data 
See B44 for more information. 


Internal Character Code Conversion 

Two variables are used to retain the current character being 
processed <for both reading and writing); ATACHR contains the 
value passed to or from CIO, and CHAR contains the internal code 
correspond ing to the value in ATACHR. Because the harduiare does 
not interpret ATASCII characters directly, the transformations 
shoton belobt are applied to all text data read and written: 


ATASCII 
CODE 


INTERNAL 

CODE 


00-1F 
20-3F 
40-SF 
60-7F 
80-9F 


40-5F 
00-1F 
20-3F 
60-7F 
CO-DF 
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AO-BF 

CO-DF 

EO-FF 


S0-9F 

AO-BF 

EO-FF 


See P26 for mors Information. 


B54 ATACHR CQ2FB,13 — Last ATASCII character or plot point 

ATACHR contains ttie ATASCII value for the most recent character 
read or written, or the value of the graphies point. This 
variable can also be considered to be a Parameter of the 
FILL/DRAW commands. as the value in ATACHR will determine the 
line color when a DRAW or FILL is performed. 


B55 CHAR# C02FA,11 — Internal character Code 

CHAR contains the internal code value for the most recent 
character read or (Dritten. 


C. DISKETTE HÄNDLER 

See Section 5 for a discussion of the resident Diskette Händler, 

CI BUFADR# 10015t21 — Data buffer pointer 

BUFADR acts as temporary page zero pointer to the current 
diskette buffer. 


C2 DSKTIM* £0246,11 — Disk format Operation timeout time 

DSKTIM contains the timeout value for SIQ calling sequence 
variable DTIMLO < see Section 9>. DSKTIM is set to 160 (uthich 
represents a 171-second timeout) at initialization timet and is 
updated after each diskette status request Operation. It contains th© 
value returned in the third byte of the status frame (see Section 
5). Note that all diskette operations other than format have a 
fixed (7) second timeout, established by the Diskette Händler. 


D. CASSETTE 

See Section 5 for a general description of the Cassette Händler. The 
cassette uses the Serial I/O bus harduare, but does not eonfarm luith 
the Serial I/O bus protocol as defined in Section 9. Hence, the Serial 
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I/O utility (SIQ) has cassette specific code within it. Same variables 
in this subsection are utilized by SIO and some by the Cassette 
Händler, 


Baud Rate Determination 

The input baud rate is assumed to be a nomina 1 600 baud, but wi 11 
be adjusted, if necessary« by the SIO routine to account for 
drive-motor variations, stretched tape> etc. The beginning of 
every cassette record contains a pattern of alternating 1's and 
zeros that is ussd solely for speed correction; by measuring the 
time to read a fixed number of bits, the true-receive baud rate 
is determined and the hardware adjusted accordingly. Input baud 
rates ranging from 318 to 1407 baud can theoretically be handled 
using this technique. 

The input baud rate is adjusted by setting the POKEY counter that 
Controls the bit sampling period. 

Dl CBAUDL* C02EE,13 and CBAUDH* C02EF, 13 — Cassette baud rate 

Initialized to 05CC hex* which represents a nominal 600 baud. 
After baud rate calculation* these variables will contain PÖKEY 
counter values for the corrected baud rate. 


D2 TIMFLÖ* £0317,13 — Baud rate determination timeout flag 

TIMFLG is used by SIO to timeout an unsuccessful baud rate 
determination. The flag is initially set to 1* and if it attains a 
value of zero (after 2 seconds) before the first byte of the cassette 
record has been read* the Operation will be aborted. See also H24. 


D3 TIMER1* C030C.23 and TIMER2* £0310,23 — Baud rate timers 

These timers contain reference times for the beginning and end of 
the fixed bit pattern receive period, The first byte of each 
timer contains the then current vertical line counter value read 
from ANTIC, and the second byte of each timer contains the then 
current value of the least significant byte of the OS real time 
clock (RTCLOK+2). 

The difference between the timers is converted to raster pair 

counts and is then used to perform a table lookup with 

interpolation to determine the new values for CBAUDL and CBAUDH. 


D4 ADOCOR* £030E,13 — Interpolation adjustment variable 
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ADOCOR is a temporary variable used for the Interpolation 
calculation of the above computation. 


D5 TEMPI* CG312/23 — Temporary storage 


D6 TEMP3* £0315/13 — Temporary storage 


D7 SAVIO* £0316/13 — Serial in data detect 

SAVIO is used to retain the state of SKSTAT CD20F3 bit 4 (serial 
data in>; it is used to detect (and is updated after) every bit 
arrival. 


Cassette Mode 


DS CASFLG* £030F,13 — Cassette I/O flag 

CASFLG is used internally by SIO to controi the program flom 
through shared code. A value of zero indicates that the current 
Operation is a Standard Serial I/O bus Operation/ and a nonzero 
value indicates a cassette Operation. 


Cassette Buffer 


D9 CASBUF* £03FD.1313 ~ Cassette record buffer 

CASBUF is the buffer used by the Cassette Händler for the packing 
and unpacking of cassette-record data« and by the initialization 
cassette-boot logic. The format for the Standard cassette record 
in the buffer is shouin belotii: 


7 6543210 

+ -+—h—h—h-+— 


1010101011 

CASBUF+0 

loioioioi: 

+■—h—t—+—'+—■1-►—► “+ 

+ 1 

! controi byte l 

+2 

i 128 : 

= data = 

+3 

! bytes ! 

•+•130 


See Section 5 for an explanation of the Standard cassette-record 
f ormat. 
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DiO BLIM* CQ28A.13 — Cassette record data size 

BL1M contains the count of the number of data bytes in the 
current cassette record being read. BLIM will have a value 
ranging from i to 128. depending upon the record control byte as 
explained in Section 5. 


Dil BPTR* C0Q3D,13 — Cassette-record data indes 

BPTR contains an Index into the data portion of the cassette 
record being read or written. The value will ränge front 0 to the 
then current value of BLIM. When BPTR equals BLIM then the buffer 
(CASBUF) is full if writing or empty if reading. 


Internal Working Variables 


D12 FEOF* CQQ3F,13 — Cassette end-of-file flag 

FEOF is used by the Cassette Händler to flag the detection of an 
end of file condition (control byte = $FE>. FEOF equal to zero 
indicates that an EOF has not yet been detected. and a nonzero 
value indicates that an EOF has been detected. The flag is reset 
at every OPEN. 


D13 FTYPE* C003E.il — Interrecord gap type 

FTYPE is a copy of ICAX2Z from the OPEN command and indicates the 
type of interrecord gap selected; a positive value indicates 
normal record gaps. and a negative value indicates continuous 
mode gaps. 


D14 WMODE* 10289. 13 — Cassette read/write mode flag 

WMODE is used by the Cassette Hand 1er to indicate whether the 
current Operation is a read or u/rite operatiom a value of zero 
indicates read, and a value of $80 indicates uirite. 


015 FREG* C0040,13 — Beep count 

FREQ is used to retain and count the number of beeps requested of 
the BEEP routine by the Cassette Händler during the OPEN command 
proc ess. 
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E. KEYBOARD 


See Section 5 for a general description of the Keyboard Händler. 


Key Reading and Debouncing 

The console key code register is read in response to an IRQ 
interrupt that is generated whenever a key stroke is detected by 
the hardtuare. The key Code is compared wi th the prior key code 
accepted (CHi); i f the codes are not identical, then the new code 
is accepted and stored in the key code FIFO (CH) and in the prior 
key code variable <CH1>. If the codes are identical> then the new 
code is accepted only if a suitable key debounce delay has 
transpired since the prior value was accepted, 

If the key code read and accepted is the code for CCTRLl 1, then 
the display start/stop flag (SSFLAG) is complemented and the 
value is not stored in the key code FIFO (CHI. 

In addition to the reading of the key data* SRTIMR is set to *30 
for all interrupts received (see ES)/ and ATRACT is set to 0 
whenever a new code is accepted (see B10>. 

The Keyboard Händler obtains all key data fro<n CHi whenever a 
code is extracted from that l~byte FIFO. the Händler Stores a 
value of *FF to the FIFO to indicate that the code has been read. 
See Section 5 for further discussion of the Keyboard Handler's 
Processing of the key codes. 


El CHI* CQ2F2,13 — Prior keyboard character code. 

CHI contains the key code value of the key most recently read and 
accepted. 


E2 KEYDEL# C02Fi.lI -Debounce delay timer. 

KEYDEL is set to a value of 3 whenever a key code is accepted/ 
and is decremented every 60th of a second by the stage 2 VBLANK 
process (until it reaches zero). 


E3 CH C02FC.13 — Keyboard character code FIFO. 

CH is a i-byte FIFO that contains either the value of the most 
recently read and accepted key code or the value *FF (which 
indicates that the FIFO is empty). The FIFO is normally read by 
the Keyboard Händler, but can be read by a user program. 

Key data can also be stored into CH by the Autorepeat logic as 
explained in the discussion relating to ES. 
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Special Functions 


Start/Stop 

Display Händler and Screen Editor output to the text or graphics 
mode screen can be stopped and started (without losing any of the 
output data) through the use of the ECTRL3 1 key combination. 

Each key depression toggles a flag that is monitored by the above 
mentioned Händlers. When the flag is nonzero/ the handlers wait 
for it to go to zero before continuing any output. 


E4 SSFLAG C02FF,13 — Start/stop flag 

The flag is normally zero, indicating that screen output is not 
to be stopped. The flag is complemented by every occurrence of 
the CCTRL3 1 key combination by the keyboard IRQ Service routine, 

The flag is set to zero upon power-up, [SYSTEM.RESET3 or CBREAK3 
key Processing. 


CBREAK3 Key 


ES BRKKEY EOOIl,13 — CBREAK3 key flag 


BRKKEY is used to indicate that the L BREAK3 key has been pressed. 
The value is normally nonzero and is set to zero whenever the 
CBREAK3 key is pressed. The code that detects and processes the 
CBREAK3 condition <flag = O) should set the flag nonzero again. 

BRKKEY is monitored by the following OS routines: Keyboard 
Händler, Display Händler, Screen Editor, Cassette Händler, xx? 
The detection of a tBREAK3 condition during an I/O Operation 
will cause the Operation to be aborted and a status of $80 to be 
returned to the user. 

The flag is set to nonzero upon Power-up, [SYSTEM.RESET3 or upon 
aborting a pending I/O Operation. 


CSHIFT3/[CONTROL3 Lock 

The keyboard control has three different modes for code 
generation that apply to the alphabetic keys A through Z: 
1) normal, 2) caps lock, and 3) control lock. 
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In normal modei all unmodified alphabetic character keys generate 
the lowercase letter ATASCII Code ($61-7A), 

In caps lock mode/ all unmodified alphabetic character keys 
generate the uppercase letter ATASCII code <$41-5A). 

In control lock mode, all unmodified alphabetic character keys 
generate the control letter ATASCII code ($01-1A>. 

In all three modes, any alphabetic character key that is modified 
<by being pressed in conjunction with the CSHIFT3 or CCTRL3 key) 
will generate the desired modified code. 


E6 SHFLOK C02BE,13 — Shift/contro1 lock control flag 

SHFLOK normally has one of three values: 

*00 = normal mode (no locks in effect). 

$40 » caps lock. 

$80 ** control lock. 

SHFLOK is set to *40 upon Power-up and CSYSTEM. RESET3 and is 
modified thereafter by the OS only when the CCAPS.LOWER3 key is 
pressed <either by itself or in conjunction with the CSHIFT3 or 
ECTRL3 key). 


E7 HÖLDCH* C007C/13 -- Character holding variable 

HDLDCH is used to retain the current character value prior to the 
CSHIFT3/CCONTROL3 logic process. 


Autorepeat 

The Autorepeat feature responds to the continuous depression of a 
keyboard key by replicating the key code 10 times per second, 
after an initial 1/2 second delay. The timer variable SRTIMR is 
used to control both the initial delay and the repeat rate. 

Whenever SRTIMR is equal to zero and a key is being held down, 
the value of the key code is stored in the key code FIFO <CH>. 
This logic is part of the stage 2 VBLANK process. 


ES SRTIMR* C022B,13 — Autorepeat timer 

SRTIMR is controlled by two independent processes: 1) the 
keyboard IRQ Service routine, which establishes the initial delay 
value and 2) the stage 2 VBLANK routine that establishes the 
repeat rate, decrements the timer and implernents the auto repeat 
logic. 
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Inverse Video Control 


The Keyboard Hand 1er a 1 lows the direct generation of more than 
half of the 236 ATASCII Codes; but codes $80-9A and Codes $A0- FC 
can be generated only with the “inverse Video mode" active. The 
ATARI key acts as an on/off toggle for this mode, and all 
characters (except for screen editing control characters) will be 
subject to inversion when the mode is active. 


E9 INVFLG CQ2S6.13 — Inverse Video flag 

INVFLG is normal ly zero, indicating that normal Video ATASCII 
codes (bit 7 » O) are to be generated from keystrokes; whenever INVFLG 
is nonzero. inverse Video ATASCII codes (bit 7 = i) will be generated. 
The special control Codes are exempt from this bit manipulation. 

INVFLG is set to zero by power-up and System reset. 

The Keyboard Händler inverts bit 7 of INVFLG whenever the ATARI key 
is pressed; the lower Order bits are not altered and are assumed to be 
zero. 

The Keyboard Händler's "exclusive or's" (XÖR's) the ATASCII key data 
with the value in INVFLG at all times; the normal values of $00 and 
$80 thus lead to control of the inverse video bit (bit 7). 


Console Keys: CSELECT3,CSTART3, and COPTION3 

The console keys are sensed directly from the hardware 
register CONSOL CD01F3; see the ATARI Home Computer 
Hardware Manual for details. 


F. PRINTER 

See Section 5 for a general description of the Printer Händler. 


Printer-Buffer 


Fl PRNBUF# C03C0.403 — Printer-record buffer 


PRNBUF is the buffer used by the Printer Händler for packing printer 
data to be sent to the device Controller. The buffer is 40 bytes long 
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and contains nothing but printer data. 


F2 PBUFSZ# [QQlEi13 — Printer-record size 

PBUFSZ contains the size of the Printer-record for the current tnode 
selected; the modes and respective sizes (in decimal bytes) are shown 
below: 


Normal 40 

Double fuidth 20 (not currently supported by the device) 
Sidetuays 2? 

Status request 4 


F3 PBPNT* COOID.13 — Pr inter-buffer index 

PBPNT contains the current index to the Printer-buffer, PBPNT ranges 
in value from zero to the value of PBUFSZ. 


Internal Working Variables 

F4 PTEMP* C001F,13 — Printer Händler temporary data save 

PTEMP is used by the Printer Händler to temporarily save the value of 
a character to be output to the printer. 


F5 PTIMOT» £001C* 13 — Printer timeout value 

PTIMQT contains the timeout value for SIO calling sequence variable 
DTIMLO (see Section 9); PTIMOT is set to 30 (which represents a 32 
second timeout) at intialization timei and is updated after each 
Printer status request Operation to contain the value returned in the 
third byte of the status frame (see Section 5). 


G. CENTRAL I/O ROUTINE (CIO) 


See Section 5 for a description of the Central I/O Utility, 


User Call Parameters 
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CIO call parameters ars 
Block (IOCB>; although 
returned in DVSTAT, and 
device tabls (HATABS). 


passed primarily through an I/O Control 
additional device status Information can be 
Händler Information is obtained from the 


I/O Control Block 


IOCB 
ui th 


is the name applied collectively to the 16 bytes associated 
each of the 8 provided control structures, see Section 5. 


Gl IOCB C0340*163 — I/O Control Block 


The label IOCB is the location of the first 
the data base. For VIDs G2 through G10, the 
IOCB #0 only, the addresses for all of the 


byte of the first IOCB 
addresses given are for 
IOCB's are shown belotif: 


in 


0340-034F 

0350-035F 

0360-036F 

0370-037F 

0380-038F 

0390-Ö39F 

03A0-03AF 

03B0-03BF 


IOCB #0 
IOCB #1 
IOCB #2 
IOCB #3 
IOCB #4 
IOCB #5 
IOCB #6 
IOCB #7 


G2 ICHID 10340/13 Händler ID 

See Section 5. Initialized to $FF at power-up and System reset. 


G3 ICDNO £0341i13 ~~ Device number 
See Section 5. 

G4 ICCQM £0342/13 — Command byte 
See Sec t ion 5. 


G5 ICSTA £0343/13 -- Status 
See Section 5. 


G6 ICBAL/ICBAH £0344,23 — Buffer address 
See Section 5. 
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G7 ICPTL,ICPTH C0346,23 — PUT BYTE vector 

See Seetion 5. Initialized to point to CIQ's "IOCB not OPEN“ routine 
at power-up and System resst. 

G8 ICBLL,ICBLH £0348,23 — Buffer length / byte count 
See Seetion 5. 

G9 ICAX1,ICAX2 E034A, 23 — Auxiliary Information 
See Seetion 5. 

GIO ICSPR £0340,43 — Spare bytes for Händler use 

There is no fixed assignment of these four bytes; the Händler 
associated with an IOCB can or may not use these bytes. 


Device Status 


G11 DVSTAT E02EA,43 — Device Status 

See Seetion 5 for a discussion of the GET STATUS command. 


Device Table 


G12 HATABS E031A,383 — Device table 

See Seetion 9 for a description of the device table. 


CIQ/Handler Interface Parameters 


Communication between CIO and a Händler is accomplished using the 
6502 machine registers, and a data structure called the Zero-page 
IOCB (ZIQCB>. The ZIOCB is essentially a copy of the particular 
IOCB being used for the current Operation. 
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Zero-Page IOCB 


ZIOCB (IOC8AS> £0020» 163 —— Zero—page IOCB 

The Zero-page IOCB is an exact copy (except as noted in the 
d iscuss ions t hat f o 1 lou») of the IOCB spec i f ied by the 6502 X 
register upon entry to CIO; CIO copies the outer level IOCB to 
the Zero-page IOCB» performs the indicated function» moves the 
(possibly altered) Zero-page IOCB back to the outer 1eve1 IOCB» 
and then returns to the caller. 

Although both the outer level IOCB and the Zero-page IOCB are 
defined to be 16 bytes in size, only the first 12 bytes are moved 
by CIO. 


G14 ICHIDZ £0020» 13 — Händler index number 
See Section 5. Set to *FF on CLOSE. 


G15 ICDNOZ £0021»13 — Device drive number 
See Section 5. 


G16 ICCOMZ £0022»13 — Command byte 
See Section 5. 


G17 ICSTAZ 10023»13 — Status byte 
See Section 5. 


GIS ICBALZ»ICBALH £0024»23 —— Buffer address 

See Section 5. This pointer variable is modified by CIO in the 
course of Processing some commands» houtever» the original value 
is restored before returning to the caller. 


G19 ICPTLZ»ICPTHZ 

See Section 5. Set to point to CIO's "IOCB not OPEN“ routine on 
CLOSE. 

Ö2Ö ICBLLZ»ICBLHZ £0023»23 — Buffer length / byte count 

See Section 5. This double-byte variable» which Starts out 
representing the buffer length» is modified by CIO in the course 


336 


OPERATING SYSTEM CQ16555 — Appendix L 



of processirtg some commands; then/ before returning to the 
caller/ the transaction byte count is stoned therein. 

G21 ICAXiZiICAX2Z CGG2A,23 — Auxi1lang information 
See Section 5. 


G22 ICSPRZ <ICIDNOiCIÖCHR > C002C, 43 — CIO working variables 

ICSPRZ and ICSPRZ+i are used by CIO in obtaining the appropriate 
Hand 1 er entry point from the hand1er 's vector table (see Section 9). 

ICSPRZ+2 is also labeled ICXONO and retains the value of the 6502 X 
register from CIO entry. The X register is loaded from ICIDNO as CIO 
returns to the call er. 

ICSPRZ+3 is also labeled CIOCHR and retains the value of the 6502 A 
register from CIO entryf except for data reading type commands/ in 
which case the most recent data byte read is stored in CIOCHR. The 
6502 A register is loaded from CIOCHR as CIO returns to the caller. 


Internal Working Variables 


G23 ICCOMT* 10017/13 — Command table index 


ICCOMT is uspd as an index to CIO's internal 
command byte values to Händler entry offsets 
information). ICCOMT contains the value from 
is greater than $0E. in which case ICCOMT is 


command table/ which maps 
(see Section 9 for more 
ICCOMZ except tirhen ICCQMZ 
set to $0E. 


024 ICIDNO# C002E/13 — CIO call X register save/restore 
See 022. 


G25 CIOCHR# C002F/13 — CIO call A register save/restore 
See G22. 


H. SERIAL I/O ROUTINE (SIO) 

See Section 9 for discussions relating to SIO. 


OPERATING SYSTEM C016555 — Appendix L 


237 



User Call Parameters 

SIÖ call Parameters are passed primarily through a Device Control 
Block; although an additional "noisy bus“ Option exists that is 
selectable through a separate variab1e. 


Device Control Block 


Hl DCB C0300»123 — Device Control Block 

DCB is the name applied collectively to the 12 bytes at locations 
G3Ö0-Q30B. These bytes provide the Parameter passing mechanism for SIO 
and are described individually belou;. 


H2 DDEVIC 10300t11 — Device bus ID 
See Section 9. 


H3 DUNIT £0301r13 — Device unit number 
See Section 9. 


H4 DCOMND £0302,13 — Device command 
See Section 9. 


H5 DSTAT5 E0303.il — Device status 
See Section 9. 


Hä DBUFLO,DBUFHI £0304.23 — Händler buffer address 
See Section 9. 

H7 DTIMLO £0306,13 — Device timeout 
See Section 9. 

H8 DBYTLG.DBYTHI £0308,23 — Buffer length / byte count 
See Section 9. 
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H9 DAUXi.DAUX2 C030A, 23 — Auxiliary Information 
See Section 9. 


Bus Sound Control 


HIO SOUNDR C0Ö41.13 — Guiet/noisy I/Ö flag 

SOUNDR is a flag used to indicate to SIO whether noise is to be 
generated on the television audio Circuit when Serial I/O bus 
activity is in progress. SOUNDR equal to zero indicates that 
sound is to be inhibited, and nonzero indicates that sound is to 
0 0 ert-abl&d, SIO ssts SOUNDR to 3 at pouför-up and System res et. 


Serial Bus Control 
Retry Logic 

SIO will attempt one complete command retry if the first attempt 
is not error free, where a complete command try consists of up to 
14 attempts to send {and acknowledge) a command frame, followed 
by a single attempt to receive COMPLETE and possibly a data 
f rame. 


Hl 1 CRETRY* CQ036,13 ~~ Command frame retry counter 

CRETRY Controls the inner loop of the retry logic, that associated 
with sending and receiving an acknowledgement of the command frame. 
CRETRY is set to 13 by SIO at the beginning of every command 
initiation. thus allowing for an initial attempt and up to 13 
additional retries. 


H12 DRETRY* C0037,13 — Device retry counter 

DRETRY Controls the outer loop of the retry logic» that 
associated with initiating a command retry after a failure 
subsequent to the command frame acknowledgement. DRETRY is set to 
1 by SIO at entry» thus allowing for an initial attempt and 
1 additional retry. 
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Chec ksurn 


The Serial I/O bus protocol speciFies that all command and data 
•Frames must contain a checksum Validation bytei this byte is the 
arithmetic sum (with end-around carry) oF all of the other butes 
m the Frame, 


H13 CHKSUM* £0031,1] — Checksum value 

CHK5UM contains the frame checksum as computed by SIO For all Frame 
transFers. 


H14 CHKSNT* C003B,13 — Checksum sent Flag 

CHKSNT indicates to the serial bus transmit Interrupt service 
routine whether the Frame checksum byte has been sent yet, CHKSNT 
equal to zero indicates that the checksum byte has not yet been 
sent, aFter the checksum is sent« CHKSNT is then set nonzero. 


Hl5 NOCKSM* £0030,13 — No checksum Follows data Flag 

NOCKSM is a Flag used to communicate between the SIO top level 
code and the Serial bus receive interrupt service routine that 
the next input will not be Followed by a checksum byte. A value 
oF zero speciFies that a checksum byte will Follow. nonzero speciFies 
that a checksum byte will not Follow. 


Data BuFFering 


General BuFFer Control 


H16 BUFRLO* £0032,13 and BUFRHI* 10033,13 — Next byte address 

8UFRL0 and BUFRHI comprise a pointer to the next buFFer location 
to be read From or written to. For a data Frame transFer, the 
pointer is initially set to the value contained in the SIO call 
Parameters DBUFLO and DBUFHI, and is then incremented by the 
interrupt service routines as a part oF normal bus data transFer. 
For a command Frame transFer, the pointer is set to point to the 
SlÖ-maintained command Frame output buFFer. 


H17 BFENL.O* 10034,13 and BFENHI* £0035,13 — BuFFer end address 

BFENLG/BFENHI Form a pointer to the byte Following the last Frame 
«data byte (not including the chec ksurn) to be sent or rece i ved. 
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BFENLO/BFENHI is the arithmetic sum of BUFRLÜ/BUFRHI plus the 
frame size plus -1. 


Command Frame Output Buffer 

See Section 9 for the command frame format and description. 

H18 CDEVIC* C023A.il — Command frame device ID 

CDEVIC is set to the value obtained by adding SIO call parameter 
DDEVIC to DUNIT and subtracting 1. 

H19 CCOMND* C023B.il — Command frame command. 

CCOMND is set to the value obtained from SIO call parameter 
DCOMND. 

H20 CAUX1* C023C,11 and CAUX2* C023D,11 — Auxiliary Information 

CAUXi and CAUX2 are set to the values obtained from SIO call 
Parameters DAUX1 and DAUX2« respectively. 


Receive/Transmit Data Buffering 


H2i BUFRFL* C0038,11 — Buffer full flag 

BUFRFL is a flag used by the serial bus receive Interrupt Service 
routine to indicate when the main portion of a bus frame has been 
received — all but the checksum byte. BUFRFL equal to zero 
indicates that the main portion has not been completely received. 
a nonzero value indicates that the main portion has been 
received. 


H22 RECVDN* C0039.il — Receive frame done flag 

RECVDN is a flag used by SIO to communicate bettueen the Serial 
bus receive interrupt service routine and the main SIO code. The 
flag is initially set to zero by SIO. and later set nonzero by 
the interrupt service routine after the last byte of a bus frame 
has been received. 


H23 TEMP* C023E.il — SIO 1-byte I/O data 
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TEMP is used to receive 1-byte responses from serial bus 
Controllers» such as ACK. NAK* CGMPLETE or ERROR. 


H24 XMTDON* C003A*11 — Transmit frame done flag 

XMTDON is a flag used by SIO to communicate between the Serial 
bus transmit interrupt Service routine and the main SIO code. The 
flag is initially set to zero by SIO* and later set nonzero by 
the interrupt Service routine after the last byte of a bus frame 
has been transmitted. 


SIO Timeout 

SIO uses System Timer i to provide the timeout capability for 
various operations initiated internally. See Section 6 for a 
discussion of the capabilities of the System Timers. TIMFLG is 
the flag used to communicate between SIO and the timer initiated 
code pointed to by CDTMAi. 


H25 TIMFLG* E0317.il — SIO Operation timeout flag 

TIMFLG is used to indicate a timeout Situation for a bus 
Operation . The flag is initially set to 1. and if it attains a 
value of zero (after the timeout period) before the current 
Operation is complete. the Operation will be aborted. See also 
D2. 


H26 CDTMV1* E0218.21 — System Timer 1 value 

This 2-byte count tafces on various values depending upon the 
Operation being timed. See also P4. 


H27 CDTMAI* E0226*23 — System Timer 1 address 

This vector aluiays points to the JTIMER routine* whose only 
function is to set TIMFLG to zero. This vector is initialized by 
SIO before every use. so that System Timer 1 can be used by any 
process that does not use SIO within a timing function. See also 
P5. 
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Internal Working Variables 


H28 STACKP* [0318»13 — Stack pointer save/restore 

STACKP contains the value of the 6502 SP register at entry to 
SIÖj this is retained to faeilitate a direct error exit froui an 
SIO subroutine. 


H29 TSTAT# C0319»13 —— Temporary Status 

TS TAT is used to return the Operation Status front the WAIT 
routine and ttfill contain one of the SIO status byte values as 
shown in Appendix 8. 


H30 ERRFLG* C023F,13 — I/O error flag 

ERRFLG is used for communication between the WAIT routine and the 
outer level SIO code. ERRFLG is normally zero» but is set to KFF 
when a device responds with an invalid response byte. 


H31 STATUS# £0030»13 —~ SIO Operation Status 

STATUS is a zero-page variable that is used within SIO to contain 
the Operation status that will be stored to the ealling seyuence 
Parameter variable DSTATS when SIO returns to the caller. 


H32 SSKCTL* C0232»13 — SKCTL copy 

SSKCTL is utilized by SIO to keep track of the content of the 
SKCTL [D20F3 register» which is a write~only register. 


J. ATARI CONTROLLERS 

The ATARI Controllers are read as part of the Stage 2 VBLANK 
process. The encoded data is partially decoded and processed as 
shown in the subsections that follow. 


Joysticks 

Up to four Joystick Controllers can be attached to the Computer 
console» each with a 9-position Joystick plus a trigger button. 
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Jl STICKO - STICK3 £0278,43 — Joystick position sense 

The 4 Joystick position sense variables contain a bit-encoded 
Position sense as shotun belotu: 


76543210 

•+*—I-t-— V —h—•!-h— V— + 

iO 0 0 OfRSLiDSUS 

where: R = 0 indicates Joystick RIGHT sensor true. 

L 0 indicates Joystick LEFT sensor true. 

D = 0 indicates Joystick DOWN sensor true. 

U “ 0 indicates Joystick UP sensor true. 

Nine uniq.ue combinations are possible, indicating the possible 
Joystick positions s ho tun beloui: 


CENTER $0F 
UP $0E 
UP/RIGHT $06 
RIGHT $07 
DOWN/RIGHT $05 
DOWN $0D 
DOWN/LEFT $09 
LEFT $0B 
UP/LEFT $ÖA 


J2 STR IGO — STRIG3 £0284,43 —~ Joystick trigger sense 

The four Joystick trigger sense variables each contain a single bit 
indicating the position of the Joystick trigger as shotun belotu: 


76543210 

lOOÖÖOOOtTJ 

tuhere: T * 0 indicates trigger pressed. 


Paddles 

Up to eight paddle controllers can be connected to the computer, 
each with a Potentiometer and a trigger sense. 


J3 PADDLO — PADDL7 £0270,83 —— Paddle position sense 

There is a single-byte variable associated tuith each paddle 
Position sense; the values ränge from 228 for full 
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counterclockwise rotation to 1 for full clocfcwise rotation. 

The paddle values are often converted by the us#r< as shotim 
below* to glve a reeult of 0 for full counterclockwise rotation 
and 227 for full clockwise rotation: 

VALUE :- 228 - PADDLX; 

J4 PTR 100 - PTRIG7 CÜ27C,83 — Paddle trigger sense 

The 8-paddle trigger sense variables each contain a single bit 
indicating the position of the paddle trigger as shotim below: 

7 6 5 4 3 2 1 0 
+-+-+-+-+-+-+-+-+ 

1000000 0IT! 


where: T = 0 indicates trigger pressed. 


Light Pen 

The OS reads the position of a single light pen and Stores the 
hörizonta 1 and vertica 1 position codes in two variables; these codes 
are not the same as the actual screen coordinates. The pen position 
codes for different portions of the screen are shotim bei out: 

Left edge — 67. 

Codes increase in increments of one to a value of 227* then go to 0 
and continue to increase monotonically tone count per color clock). 
Right edge — 7. 

Upper edge — 16. 

Codes increase in increments of one (one count per two raster 
lines). Lower edge — 111. 

The light pen harduiare will read and latch the pen position 60 times 
per second * independent of the pen button position* uh ich is 
separate ly sensed. 

In order for the light pen to operate it must be positioned over a 
portion of the screen which has sufficient luminance to activate the 
photosensor in the pen; a blank <dark) screen will generally not 
provide enough luminance to utilize the light pen. 

J5 LPENH C0234,13 — Light pen horizontal position code 

LPENH contains the horizontal position code for the light pen; the 
algorithm below (written in Pascal) shows the conversion from■position 
code to screen coordinate (screen mode 7): 

IF LPENH <33 < check for rollover point > 

THEN < adjust values to right of rollover > 
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XPQS := LPENH + 227 

ELSE -C no ad j ustment to left of rollover point > 

XPOS : « LPENH; 

XPOS :» XPOS ~ 67; •£ ad just for left edge offset > 

IF XPOS < 0 THEN XPOS :« 0; 

IF XPOS > 159 THEN XPQS := 159; 

J6 LPENV C0235* 13 — Light pen vertical position code 

LPENV contains the vertical position code for the light pen; the 
algorithm belour (uritten in Pascal) shows the conversion from position 
code to screen coordinate (screen mode 7): 

YPOS :« LPENV - 16; < ad just for upper edge offset > 

IF YPOS < 0 THEN YPOS :* 0; 

IF YPOS > 95 THEN YPOS :« 95; 

J7 STICKO - STICK3 C027S, 43 — Light pen button sense 

The light pen button sense is encoded in one of STICKO - STICK3 
(depending upon the actual Controller port used) as shoun 
belau: 

7 0 

+“4-~+-+~+—K-+-+- + 

! i 010 : 0 i TI 

uh er e: T => 0 indicates the light pen button is pressed. 


Driving Controllers 

The driving control1er has no position stops and thus allous uniimited 
rotation in either direction; the output of the Controller is a 2—bit 
Gray code uhich can be used to determine the direction of rotation. 

The contro11er is sensed using the same interna 1 harduare as the 
Joystick* thus the same data base variables are used for both. 
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\J8 STICKO STICK3 C0278i 43 Driving Controller sense 

The 4 driving Controller sense variables contain an encoded 
rotation (position) sense value, as shown below: 

76543310 

: o o o o i i i va i: 

+—)—4-~-)—i—I—i— y 

uhere a clockwise rotation of the Controller produces the following 
cont inuous sequence of f our val ues < sh own in he xadec imal >: 


OF, ÖD» OC, OE. OF, 00.. 

and a counterclockwise rotation of the Controller produces the 
follouiing continuous sequence of four values: 

OF, OE, OC, 00, OF, OE,. 


J9 STRIGO — STRIG3 £0264,43 — Driving trigger sense 

The four driving trigger sense variables each contain a single bit 
indicating the position of the driving trigger as sh own belour: 

765433 10 

+- 4 ._ + _ + _ + „ + _ + „ + _ 4 . 

:o o o o o o oit: 

+ _ + „ + _ + _ 4 ._ + „ 4 ._ + _ + 


tuhere: T = Ö indicates trigger pressed. 

K. DISK FILE MANAGER 

See Section 5 for Information relating to the Disk File Manager. 

Kl FMSZPC» C0043,73 — FMS reserved space 

FMSZPG is the reserved space in the database for the variables shown 
below; the names associated with K2 through K5 are not in the System 
equate file. 

K2 ZBUFP* £0043,23 — Buffer pointer 
K3 ZDRVA# £0045,23 Drive pointer 
K4 ZSBA* £0047,23 — Sector buffer pointer 
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K5 ERRNO* C0049»13 —— Error numfaer 


L. DISK UTILITY POINTER 

Li DSKUTL* EQOIA» 23 — Page-rero pointer variable 

M. 'FLOATING POINT PACKAGE 

See Section 8 for a description of the Floating Point Packag 

Ml FRO C00D4 ( 63 —~ FP register 0 

M2 FRE» COÖDAj 63 ■— FP register (internal) 

M3 FRi COÖEÖ» 63 — FP register 1 

M4 FR2» E00E6*63 — FP register 2 (internal) 

M5 FRX# COGECi13 — Spare (unused) 

M6 EEXP* EOÖEDi 13 — Exponent value (internal) 

M7 NSIQN* EOOEE»13 — Sign of mantissa (internal) 

M8 ESIGN* EÖOEFfll — Sign of exponent (internal) 

M9 FCHRFLG* CÖQFO*13 — First character flag (internal) 

MIO DIGRT* C00F1»13 — Digits to right of decitnal point 

Mil CIX E00F2»13 — Character index 

M12 INBUFF COOF3i23 — Input text buffer pointer 
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M13 ZTEMP1# EÖ0F5»23 — Temporarg storage 

M14 ZTEMP4* CG0F7,23 — Temporarg storage 

M15 ZTEMP3* CÖ0F9,23 — Temporarg storage 
M16 FLPTR COOFC, 23 — Pointer to FP number 

M17 FPTR2* COOFEi23 — FP package use 

M18 LBPR1* EQ57E,i3 — LBUFF preamble 

M19 LBPR2* E057F,13 — LBUFF preamble 

M20 LBUFF E0580,963 -- Text buffer 

M21 PLYARG* E05E0,63 — FP register (internal) 

M22 FPSCR/FSCR* C05E6,63 -- FP register (internal) 

M23 FPSCR1/SCR1* C05EC,63 — FP register (internal) 

M24 DEGFLG/RADFLG COOFB,13 — Degrees/radians flag 

DEGFLG = 0 indicates radians, 6 indicates degrees. 


N. Power-Up and SYSTEM RESET 

See Section 7 for details of the power-up and sgstem raset 
operations. 


RAM Sizing 

Düring power-up and sgstem reset the first non-RAM address above 1000 
hex is located and its address retained using a nondestruetive 
test. The first byte of everg 4K memory "block" is tested to see if 
it is alterable; if so, the original value is restored and the next 
block is tested, and if not, that address is considered to be the 
end of RAM. 
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Ni RAMLQ*/TRAMSZ* C0Ö04.33 — RAM data/test pointer (temporary) 


RAMLO+1 contains the LSB of the address to be tested (always 13 Q> 
and TRAMSZ (satne as RAMLQ+2) contains the MSB of the address to be 
tested. RAMLO+O contains the complemented value of the data 
originally contained in the memory iocation being tested. 

Later in the initialization process these variables are used for 
totally unrelated functions; but first the value in TRAMSZ is moved 
to the variables RAMSIZ and MEMTOP+1. 


N2 TSTDAT* C0007,13 — Test data byte save 

TSTDAT contains the original value of the memory Iocation being 
tested. 


Diskette/Cassette-Boot 

As a part of the Power—up sequence» Software can be booted from an 
attached disk drive or cassette player as explained in Section 10. 


N3 DOSINI COOOC > 21 — Diskette-boot initia1ization vector. 

DOSINI contains the disk booted Software initialization address 
from the beginning of the boot file (see Section 10) whenever a 
diskette-boot is successfully completed. 


N4 CKEY* C004A,13 — Cassette-boot request flag 

CKEY is an internal flag used to indicate that the console ESTART3 
key was pressed during Power-up r thus indicating that a 
cassette—boot is desired. CKEY equals zero when no cassette-boot is 
requested, and is nonzero when a cassette-boot is requested. The 
flag is cleared to zero after a cassette-boot. 

NS CASSBT* C004B,13 — Cassette-booting flag 

CASSBT is used during the cassette-boot process to indicate to 
shared code that the cassette is being booted and not the diskette. 
CASSBT equal to zero indicates a diskette—booti and nonzero indica-tes 
a cassette-boot. 


N6 CASINI C0002,23 — Cassette-boot initialization vector 

CASINI contains the cassette-booted Software initialization address 
from the beginning of the boot file tsee Section 10) whenever a 
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cassette-boot is successfully completed. 


N7 BOOT?» £0009,13 — Successful diskette/cassette-boot flag. 

i V rficat8S to the initialization processor which, if any. of 
tue boot operations want to successful completion. The flag values 
are set by the OS and the format for the variable is shoum below: 


7 6 5 4 3 2 1 0 

+—4-—1-—•+•—+—+—+—h—+ 

* !C * D! 

tuhere: C - 1 indicates that the cassette-boot was completed. 

D *= 1 indicates that the diskette-boot was completed. 


N8 DFLASS* £0240,13 — Diskette flags 

DFLAGS contains the value of the first byte of the boot file, after a 
diskette-boot. See Section 10. 


N9 DBSECT* £0241,13 — Diskette-boot sector count 

DBSECT is initially set to the value of the second byte of the boot 
file, during a diskette-boot, and is then used to control the number 
of additional diskette sectors read, if any. 


N10 BOOTAD* £0242,23 — Diskette-boot memory address 

BOOTAD is initially set to the value of the third and fourth 
bytes of the boot file, during a diskette-boot, and is not 
modified thereafter. 


Environment Control 

If, at the end of a power-up or System reset, control is not 
given to one of the cartridges (as explained in Sections 7 and 10), 
then program control passes to the address contained in the data 
base variable DÖSVEC. 


Nil COLDST* £0244,13 — Coldstart complete flag 

COLDST is used by the initialization routine to detect the case of 
a System reset occurring before the completion of the power-up 
process. COLDST is set to $FF at the beginning of the power—up 
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sequence and is set to 0 at the completion; if a System reset 
occurs while the value is nonzero, the power-up sequence will be 
reinitiated (rather than initiating a System reset sequence). 


N12 DOSVEC CÖOOA, 23 — Noncartridge control vector 

At the beginning of power-up the QS sets DOSVEC to point to the 
"blackboard" routinei DOSVEC can then be altered as a consequence 
of a diskette-boot or cassette-boot (as explained in Section 10) to 
establish a new control program. Control will be passed through 
DOSVEC on all power—up and System reset conditions in which a 
cartridge does not take control -first. 


System Reset 


N13 WÄRMST CÖ008,13 — Warmstart flag 

WÄRMST equals *FF during a system reset (Warmstart) 

initialization and equals 0 during a power-up initialization 

(coldstart). 


P. INTERRUPTS 

See Section 6 -for a discussion of interrupt Processing. 

PI CRITIC C0042«13 ~ Critical code section flag 

CRITIC is used to signal to the VBLANK interrupt processor that a 
critical code section is executing without IRÖ interrupts being 
inhibitedi the VBLANK interrupt processor will-stop interrupt 
Processing after stage 1 and before stage 2t just as if the 6502 
processor I bit were set, when CRITIC is set. 

CRITIC equal to zero indicates that the currently executing code 
section is noncritical » while any non zero value indicates that the 
currently executing code section is critical. 


P2 POKMSK 10010,13 — POKEY interrupt mask 

POKMSK is a Software maintained interrupt mask that is used in 
conjunction with the enabling and disabling of the various POKEY 
interrupts. This mask is required because the POKEY interrupt 
enable register IRQEN CD20E3 is a write-only register, and at any 
point in time the system can have several users independent ly 
enabling and disabling POKEY interrupts. POKMSK is updated by the 
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users to always contain the current content of IRGEN. 


System Timers 

The System Timers are discussed in detail in Section 6. 


Realtime Clock 

The realtime clock tor frame counter» as it is sometimes called) 
is incremented as part of the stage 1 VBLANK process as explained 
in Section 6. 


P3 RTCLQK £0012.31 — Realtime frame counter 

RTCLQK+Q is the most significant byte. RTCLQK+1 the next most 
significant byte» and RTCLQK+2 the least significant byte. See the 
discussions at D3 and preceding BIO for OS use of RTCLOK. 


System Timer 1 

System Timer 1 is maintained as part of the stage 1 VBLANK process. 
and thus has the highest priority of any of the user timers. 


P4 CDTMVi £0218,23 — System Timer 1 value 

CDTMVi contains zero when the timer is inaetive. othertuise it 
contains the number of VBLANKs remaining until timeout. Also see 
H26. 


P5 CDTMAi £0226,23 — System Timer 1 jump address 

CDTMAi contains the address to tuhich to JSR should the timer 
timeout. See also H27 and Section 6. 
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System Timer 2 

System Timer 2 is maintained as part of the stage 2 VBLANK process» 
and has the second highest priority of the user timers. The ÜS does 
not have any direct use for System Timer 2. 


P6 CDTMV2 C02iA>23 — System Timer 2 value 

CDTMV2 contains zero uhen the timer is inactive» otheruise it 
contains the number of VBLANKs remaining until timeout. 


P7 CDTMA2 EÖ228»23 — System Timer 2 jump address 

CDTMA2 contains the address to uhich to JSR should the timer 
timeout. See Section 6. 


System Timers 3» 4 and 5 

System Timers 3» 4 and 5 are maintained as part of the stage 2 
VBLANK process* and have the lauest priority of the user timers. 
The DS does not have any direct use for these timers. 


PS CDTMV3 C02IC» 23/ CDTMV4 C021E,23 and CDTMV5 i 0220,23 

These variables contain zero uhen the corresponding timers are 
inactive* otheruise they contain the number of VBLANKs remaining 
until timeout. 


P9 CDTMF3 C022A. 13* CDTMF4 C022C»13 and CDTMF5 C022E, 23 

Each of these i-byte variables will be set to zero should its 
corresponding timer timeout. The OS never modifies these bytes 
except to set them to zero upon timeout (and initialization). 


RAM Interrupt Vectors 

There are RAM vectors for rnany of the interrupt conditions uithin 
the System. See Section & for a discussion of the placing of values 
to these vectors. 
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NMI Interrupt Vectors 


P10 VDSLST 10200,23 — Display-list Interrupt vector 
This vector is not used by the OS. See Section 6, 

Pli VVBLKI EÜ222,23 — Immediate VBLANK vector 

This vector is initialized to point to the OS stage 1 VBLANK 

P12 VVBLKD 10224,23 — Deferred VBLANK vector 

This vector is initialized to point to the OS VBLANK exit routine 
See Section 6. 


IRQ Interrupt Vectors 

P13 VIMIRQ £0216,23 — General IRQ vector 

This vector is initialized to point to the OS IRQ interrupt 
processor. See Section 6. 

P14 VPRCED £0202,23 — Serial I/O bus proceed Signal 

The serial bus line that produces this interrupt is not used in the 
current System. See Section 6. 


P15 VINTER 10204,23 — Serial I/O bus interrupt Signal 

The serial bus line that produces this interrupt is not used in the 
current System. See Section 6. 


PIA VC8REAK3 10206,23 —— BRK instruction vector 

This vector is initialized to point to a PLA, RTI sequence as the 
OS proper does not utilize the BRK instruction. See Section 6. 


P17 VKEYBD C0208,23 — Keyboard interrupt vector 

This vector is initialized to point to the Keyboard Händler's 
interrupt Service routine. See Section 6 and the discussion 
preceding El. 
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PIS VSERIN £020A,23 — Serial I/O bus recsive data ready 

This vector is initialized to point to the SIO utility's interrupt 
Service routine. See Section 6. 


P19 VSEROR C020C,23 — Serial I/O bus transmit ready 

This vector is initialized to point to the SIO utility's interrupt 
Service routine. See Section 6. 


P20 VSERQC CG20E,23 — Serial I/O bus transmit complete 

This vector is initialized to point to the SIO Utility's interrupt 
Service routine. See Section 6. 


P21 VTIMR1 £0210, 23 * VTIMR2 £0212,23 and VTIMR4 £0214,23 — PQKEY 
timer vectors 

The POKEY timer interrupts are not used by the OS See Section 6. 


Hardware Register Updates 

As part of the stage 2 VBLANK process, certain hardware registers 
are updated from OS data base variables as explained in Section 6. 


P22 SDMCTL* £022F,13 — DMA control 

SDMCTL is set to a value of *02 at the beginning of a Display 
Händler OPEN command, and then later set to a value of *22. The 
value of SDMCTL is stored to DMACTL £D40G3 as part of the stage 2 
VBLANK process. 


P23 SDLSTL* £0230,13 and SDLSTH* £0231,13 — Display list address 

The Display Händler formats a new display list with every OPEN 
command and puts the display list address in SDLSTL and SDLSTH. The 
value of these bytes are stored to DLISTL £D4G23 and DLISTH CD4033 
as part of the stage 2 VBLANK process. 

0360-036F IOCB #2 

0370-Ö37F IOCB #3 

0380-038F IOCB #4 

0390-039F IOCB #5 

03A0-Ö3AF IOCB #6 

03B0-03BF IOCB #7 
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NOTE: There is a potential timing p-roblem associated with the 
updating of the hardware registers from the data base variables. 
Since the stage 3 VBLANK process is performed with Interrupts 
enabledi it is possible for an IRQ Interrupt to occur before the 
updating of DLISTH and DLISTL, If the Processing of that 
interrupt (plus other nested Interrupts) exceeds the 
vertical-blank de lag <1 msec >» then the displag 1ist pointer 
register will not have been updated when displag list Processing 
commences for the new frame> and a screen glitch will result. 


P24 GPRIOR* C02AF.13 — Prioritg control 

The Displag Händler alters bits 6 and 7 of GPRIOR as part of 
establishing the OTIA mode. The value of GPRIQR is stored to 
PRIOR CD01B3 as part of the stage 3 VBLANK process. 

P35 CHAOT* E03F3,13 — Character control 

The Displag Händler sets CHACT to *03 on every OPEN command. The 
value of CHACT is stored to CHACTL CD4013 as part of the stage 3 
VBLANK process. 


P26 CHBAS C02F4»13 — Character address base 

The Display Händler sets CHBAS to *E0 on every OPEN command. The 
value of CHBAS is stored to CHBASE CD4093 as part of the stage 3 
VBLANK process. This variable Controls the character subset for 
screen modes 1 and 3i a value of *EQ provides the Capital letters 
and number set whereas a value of *E2 provides the lowercase 
letters and special graphics set. See BSD for more information. 


P27 PCOLRx 10200*43 and COLORx CQ2C4*53 — Color registers 
See B7 and B8. 


Internal Working Variables 

P28 INTEMP* CQ33D, 13 — Temporary storage 
INTEMP is used by the SETVBL (SETVBV) routine. 
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R. USER AREAS 


The areas shoum belotif are available to fcheuser in a non—nested 
environment. See Section 4 for further Information. 


Ri C0080,1283 

R2 C04S0j 6403 
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ALPHABETICAL LIST QF DATA BASE VARIABLES 


NAME 


ADDCGR 

ADRESS 

APPMHI 

ATACHR 

ATRACT 

BFENHI 

BFENLO 

BITMSK 

BLIM 

BOOT? 

BOOTAD 

BOTSCR 

BPTR 

BRKKEY 

BUFADR 

BUFCNT 

BUFRFL 

BUFRHI 

BUFRLO 

BUFSTR 

CASBUF 

CASFLG 

CASINI 

CASSBT 

CAUXi 

CAUX2 

CBAUDH 

CBAUDL 

CCOMND 

CDEVIC 

CDTMAi 

CDTMA2 

CDTMF3 

CDTMF4 

CDTMF5 

CDTMV1 

CDTMV2 

CDTMV3 


VID ADDRESS SIZE 


D4 

B39 

A3 

B54 

BIO 


030E, 1 
0064, 2 
OOOE, 2 
02FB, 1 
004D, 1 


H17 

H17 

850 

D10 

N7 

N10 

B16 

DU 

E5 

Ci 

B42 

H21 

H16 

H16 

B43 


0035, 1 
0034, 1 
006E» 1 
028A, 1 
0009, 1 
0242, 2 
02BF, 1 
003D, 1 
0011,1 
0015, 2 
006B, 1 
0038, 1 
0033, 1 
0032, 1 
0060, 2 


D9 

D8 

N6 

N5 

H2Ö 

H20 

Dl 

Dl 

H19 

H18 

P5» H27 

P7 

P9 

P9 

P9 

P4, H26 

P6 

P8 


03FD,131 
Q30F, 1 
0002, 2 
004B, 1 
023C, 1 
0230, 1 
02EF, 1 
02EE, 1 
023B, 1 
023A, 1 
0226, 2 
0228, 2 
022A, 1 
022C, 1 
022E, 1 
0226, 2 
021A, 2 
021C,2 
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CDTMV4 

PS 

021Ef 2 

CDTMV5 

PS 

0220, 2 

CH 

E3 

02FC,1 

CHKSNT 

H14 

003B.1 

CHI 

El 

02F2, 1 

CHACT 

P25 

02F3, 1 

CHAR 

B55 

02FA» 1 

CHBAS 

P26 

02F4, 1 

CHKSNT 

H14 

003B,1 

CHKSUM 

H13 

0031, 1 

CIOCHR 

G25 

002F,1 

CIX 

Mil 

Ö0F2, 1 

CKEY 

N4 

004A,1 

CDLAC 

B24 

0072, 2 

COLGRS 

B2 

0055, 2 

COLDST 

Nil 

0244,1 

COLINC 

B21 

007A, 1 

COLORO 

B8, P27 

02C4, 1 

COLOR1 

B8,P27 

02C5, 1 

C0LDR2 

B8, P27 

02C6, 1 

CQL0R3 

BSfP27 

Ö2C7, 1 

C0L0R4 

BSf P27 

02C8, 1 

COLRSH 

Bll 

004F,1 

COUNTR 

B23 

007E.2 

CRETRY 

Hl 1 

0036, 1 

CRITIC 

PI 

0042,1 

CRSINH 

Bl 

02F0,1 

CSTAT 

S2 

0288,1 

DAUX1 

H9 

030A, 1 

DAUX2 

H9 

030B, 2 

DBSECT 

N9 

0241, 1 

DBUFHI 

H6 

0304, 1 

DBUFLO 

H6 

0305. 1 

DBYTHI 

HS 

0308, 1 

DBYTLO 

HS 

0309, 1 

DCB 

Hl 

0300, 12 

DCOMND 

H4 

0302, 1 

DDEVIC 

H2 

0300, I 

DEGFLG 

M24 

OOFB,1 

DELTAC 

B22 

0077, 2 

DELTAR 

B22 

0076, 1 

DFLAGS 

NS 

0240, 1 

DIGRT 

MIO 

Ö0F1,1 

DINDEX 

B35 

0057, 1 

DMASK 

B2S 

02 AO, 1 

DOSINI 

N3 

OOOC,2 

DOSVEC 

N12 

000A, 2 

DRETRY 

H12 

0037, 1 

DRKMSK 

B12 

004E, 1 

DSKTIM 

C2 

0246, 1 

DSKUTL 

LI 

001A, 2 

DSPFLG 

B27 

02FE,1 

DSTAT 

B34 

004C,1 
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DSTATS 

H5 

0303. 1 

DTIMLG 

H7 

0306,1 

DUN IT 

H3 

0301, 1 

DUNUSE 

S3 

0307, 1 

DVSTAT 

Gl 1 

02EA,4 

EEXP 

M6 

OOED, 1 

ENDPT 

B25 

0074, 2 

ERRFLG 

H3Q 

023F, 1 

(ERRNO 

K5> 

0049, 1 

ESCFLG 

B26 

02A2, 1 

ESIGN 

M8 

OOEF, 1 

FCHRFL 

M9 

OOFO, 1 

FEOF 

D12 

003F,1 

FILDAT 

B17 

02FD, 1 

FILFLG 

BIS 

02B7, 1 

FLPTR 

Ml 6 

OOFC,2 

FMSZPG 

Kl 

0043,7 

FPSCR 

M22 

05E6, 6 

FPSCR1 

M23 

OSEC,6 

FPTR2 

M17 

OOFE, 2 

FRO 

Mi 

00D4,6 

FR1 

M3 

OOEO,6 

FR 2 

M4 

00E6, 6 

FRE 

M2 

OODA,6 

FREQ 

Dl 5 

0040, 1 

FRMADR 

B41 

0068, 2 

FRX 

M5 

OOEC,1 

FSCR 

M22 

05E6,6 

FSCR1 

M23 

OSEC,6 

FTYPE 

D13 

0Q3E,1 

GPRIGR 

P24 

026F,1 

HATABS 

G12 

031A, 38 

HGLD1 

B30 

0051, 1 

HOLD2 

B31 

029F,1 

HQLD3 

B32 

029D, 1 

HGLD4 

S20 

02BC, 1 

HOLDCH 

£7 

007C. 1 

ICAX1 

G9 

034A, 1 

XCAX1Z 

G21 

002A,1 

ICAX2 

G9 

Ö34B, 1 

ICAX2Z 

G21 

002B, 1 

ICBAH 

G6 

0345, 1 

ICBAHZ 

G18 

0025, 1 

ICBAL 

G6 

0344,1 

ICBALZ 

G18 

0024, 1 

ICBLH 

GS 

0349, I 

ICBLHZ 

G20 

0029, 1 

ICBLL 

G8 

0348,1 

ICBLLZ 

G20 

0028, 1 
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ICCOM 

G4 

0342/ 1 

ICCOMT 

G23 

0017. 1 

ICCÖMZ 

G16 

0022. 1 

ICDNO 

G3 

0341, 1 

ICDNQZ 

015 

0021,1 

ICHID 

G2 

0340, 1 

ICHIDZ 

G14 

0020, 1 

ICIDNO 

G24»G2 

2002E, 1 

ICPTH 

G7 

0347, 1 

ICPTHZ 

G19 

0027, 1 

ICPTL 

G7 

0346, 1 

ICPTLZ 

Gl? 

0026, 1 

ICSPR 

GIO 

Ö34C,4 

ICSPRZ 

G22 

002C,4 

ICSTA 

05 

0343,1 

ICSTAZ 

017 

0023, 1 

INBUFF 

M12 

00F3,2 

INSDAT 

845 

007D, 1 

INTEMP 

P28 

Ö22D, 1 

INVFLG 

E9 

02B6, 1 

IOCB 

Gl 

0340, 16 

IOCBAS 

G13 

0020, 16 

KEYDEL 

E2 

02F1,1 

LBFEND 

M20 

0580,96 

LBPR1 

M1S 

057E, 1 

LBPR2 

M19 

057F,1 

LBUFF 

M20 

0580, 96 

LINBUF 

B51 

0247, 40 

LMARGN 

B5 

0052, 1 

LOGOOL 

B15 

0063, 1 

LOGMAP 

B14 

02B2, 4 

MEMLO 

Al 

02E7, 2 

MENTOP 

A2 

02E5, 2 

MLTTMP 

B40 

0066, 2 

NE WC OL 

B19 

0061, 2 

NEWROW 

819 

0060. 1 

NOCKSM 

Hl 5 

Q03C,1 

NSIGN 

M7 

OOEE,1 

OLDADR 

B38 

005E,2 

OLDCHR 

B37 

0050,1 

OLDCOL 

B3 

Q05B,2 

OLDROW 

B3 

005A, 1 

QPNTMP 

B40 

0066, 2 

PADDLO 

J3 

0270, 1 

PADDL1 

J3 

0271,1 

PADDL2 

J3 

0272,1 

PADDL3 

J3 

0273, 1 

PADDL4 

J3 

0274, 1 
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PA00L.5 

PA00L6 

PADDL7 

PBPNT* 

PBUFSZ 

PCOLRO 

PCGLR1 

PC0LR2 

PC0LR3 

PLYARG 

PQKMSK 

PRNBUF 

PTEMP 

PTIMOT 

PTRIÖO 

PTRIGi 

PTRIG2 

PTRIG3 

PTRIG4 

PTRIG5 

PTRIG6 

PTRIG7 

RADFLG 

RAMLO 

RAMSIZ 

RAMTOP 

RECV0N 

RMARGN 

ROWAC 

RQWCRS 

ROWINC 

RTCLOK 

SAVADR 

SAVIO 

SAVMSC 

SCRFLG 

SDLSTH 

SDLSTL 

S0MCTL 

SHFAMT 

SHFLOK 

SOUNDR 

SRTIMR 

SSFLAG 

SSKCTL 

STACKP 

STATUS 

STICKO 

STICKl 

STICK2 

STICK3 

STRIGO 


J3 

J3 

J3 

F3 

F2 

B7, P27 

87. P27 

B7. P27 

B7. P27 

M21 

P2 

Fi 

F4 

FS 

J4 

J4 

J4 

J4 

J4 

J4 

J4 

J4 

M24 

NI 

AS 

A4 

H22 

B6 

B24 

B2 

B2i 

P3 

B4i 

D7 

B36 

B9 

P23 

P23 

P22 

B29 

E6 

HIO 

ES 

E4 

H32 

H28 

H31 

Jl. J7, J8 
Ji. J7, J8 
Jl. J7, J8 
dl. J7. J8 
d2. J7, J9 


0275. 1 
0276, 1 
0277, i 
0010 , 1 
Ö01E, 1 
0200 , 1 
0201 , 1 
0202 , 1 
0203, 1 
05E0, 6 
0010, 1 
0300, 40 
001F, 1 
0010, 1 
0270, 1 
0270, 1 
027E, 1 
Ö27F, 1 
0280, I 
0281, 1 
0282, 1 
0283, 1 

OOFB, 1 
0004, 3 
02E4, 1 
006A, 1 
0039, 1 
0053, 1 
0070, 2 
0054, 1 
0079, 1 
0012, 3 

0068, 2 
0316, 1 
0058, 2 
02BB, 1 
0231, 1 
0230, 1 
022F, 1 
006F, 1 
02BE, 1 
0041, 1 
022B, 1 
02FF, 1 
0232, 1 
0318, l 
0030, 1 
0278, I 
0279, 1 
027A, 1 
027B, 1 
0284, I 
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STRIG1 

02, J7, J9 

STRIG2 

02, 07, 09 

STRIG3 

02, 07, 09 

SUBTMP 

B48 

SWPFLG 

844 

TABMAP 

B13 

TEMP 

H23 

TEMPI 

D5 

TEMP 3 

D6 

TIMER1 

D3 

TIMER2 

D3 

TIMFLG 

D2,H25 

T INDEX 

B49 

TMPCHR 

B33 

TMPCOL 

B46 

TMPLBT 

B47 

TMPROW 

B46 

TOADR 

B40 

TRAMSZ 

NI 

TSTAT 

H29 

TSTDAT 

N2 

TXTCOL 

B4 

TXTMSC 

B52 

TXTOLD 

B53 

TXTROW 

B4 

USAREA 

RI 

VBREAK 

P16 

VDSLST 

P10 

VIMIRG 

P13 

VINTER 

P15 

VKEYBD 

P17 

VPRCED 

P14 

VSERIN 

P18 

VSEROC 

P20 

VSERQR 

P19 

VTIMR1 

P21 

VTIMR2 

P21 

VTIMR4 

P21 

WBLKD 

P12 

WBLKI 

Pli 

«ÄRMST 

N13 

«MODE 

D14 

XMTDON 

H24 

{ZBUFF 

K2> 

{ZDRVA 

K3) 

ZIOCB 

G13 

(ZSBA 

K4> 

ZTEMPI 

M13 


OPERATING 


0285, 1 
0286, i 
0284,4 
029E,1 
0Ö7B,1 

02A3,15 
023E,1 
0312, 2 
0315, 1 
Q3GC,2 
0310, 2 
0317, 1 
0293, 1 
0050,1 
0259,2 
02A1,1 
02B8,1 
0066,2 
0004, 3 
0319, 1 
0007, 1 
0291,2 
0294, 2 
0296, 6 
0290, 1 

0080, 128 

0206, 2 
0200, 2 
0216, 2 
0204, 2 
0208, 2 
0202, 2 
020Ai 2 

020E,2 
020C,2 
0210, 2 
0212, 2 
0214, 2 
0224, 2 
0222, 2 

0008, 1 
0289, 1 

Q03A, 1 

0043, 2 
0045, 2 
0020, 16 
0047, 2 
OQF5, 2 
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ZTEMP3 

ZTEMP4 


Ml 5 
M14 


00F9, 2 
Ö0F7, 2 
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MEMORY ADDRESS 

ORDERED HST OF DATABASE VARIABLES 

ADDRESS 

VID 

NAME 

OOOO-OOOl 

S7 

LNZBS 

0002-0003 

N6 

CASINI 

0004-0006 

NI 

RAMLO»TRAMSZ 

0007 

N2 

TSTDAT 

0008 

N13 

WÄRMST 

0009 

N7 

BOOT? 

OOOA-OOOB 

N12 

DOSVEC 

OOOC-OOOD 

N3 

DOSINI 

OOOE-OOOF 

A3 

APPMHI 

0010 

P2 

PQKMSK 

0011 

ES 

BRKKEY 

0012-0014 

P3 

RTCLOK 

0015-0016 

CI 

BUFADR 

0017 

G23 

ICCOMT 

001A-001B 

LI 

DSKUTL 

00 IC 

F5 

PTIMOT 

00 ID 

F3 

PBPNT 

00 IE 

F2 

PBUFSZ 

001F 

F4 

PTEMP 

0020 

013,G14 

ICHIDZ 

0021 

Gl 5 

ICDNOZ 

0022 

G16 

ICCOMZ 

0023 

G17 

ICOBAS 

0024-0025 

G18 

XCBALZjICBAHZ 

0026-0027 

G19 

ICPTLZjICPTHZ 

0028-0029 

020 

ICBLLZiICBLHZ 

002A-002B 

G21 

ICAXi Z> ICAX2Z 

002C-002F 

G22, G24* G25 

ICSPRZ 

0030 

H31 

STATUS 

0031 

H13 

CHKSUM 

0032-0033 

H16 

BUFRLO,BUFFRHI 

0034-0035 

H17 

BFENLOjBFENHI 

0036 

HU 

CRETRY 

0037 

H12 

DRETRY 

0038 

H21 

BUFRFL 

0039 

H22 

RECVDN 

003A 

H24 

XMTDON 

003B 

H14 

CHKSNT 

Ö03C 

H15 

NOCKSM 

Ö03D 

Dil 

BPTR 

0Ö3E 

D13 

FTYPE 

003F 

D12 

FEOF 

0040 

D15 

FREG 

0041 

H10 

SOUNDR 

0042 

Pi 

CRITIC 

0043-0049 

Kl, K2< K3 ( K4» 

K5 ZBUFFjZBUFP. ZDRVA, ZSS6 

004A 

N4 

CKEY 

004B 

N5 

CASSBT 

004C 

B34 

DSTAT 
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004D 

810 

ATRACT 

0Ö4E 

B12 

DRKMSK 

0G4F 

Bll 

COLRSH 

0050 

B33 

TMPCHR 

0051 

B30 

H0LD1 

0052 

B5 

LMARGN 

0053 

B6 

RMARGN 

0054-0056 

B2 

ROWCRSi COLCRS 

0057 

S35 

DINDEX 

0058-0059 

B36 

SAVMSC 

005A-005C 

B3 

OLDROW. OLDCOL 

005D 

B37 

OLDCHR 

005E-005F 

B38 

OLDADR 

0060-0062 

B19 

NEWROW.NEWCOL 

0063 

B15 

LOGCOL 

0064-0065 

B39 

ADRESS 

0066-0067 

B40 

MLTTMP.OPNTMP.TQADR 

0068-0069 

B41 

SAVADR/FRMADR 

Q06A 

A4 

RAMTOP 

006B 

B42 

BUFCNT 

006C-006D 

B43 

BUFSTR 

006E 

B50 

BITMSK 

006F 

B29 

SHFAMT 

0070-0073 

B24 

ROWAC,COLAC 

0074-0075 

B25 

ENDPT 

0076-0078 

B22 

DELTAR,DELTAC 

0079-007A 

B21 

ROWINC. COLINC 

007B 

B44 

SWPFLG 

0Q7C 

E7 

HQLDCH 

007D 

B45 

INSDAT 

007E-007F 

B23 

COUNTR 

0080-00FF 

SEE FLOATING 

POINT VARIABLE LIST AT 

0100-01FF 

6502 STACK 


0200-0201 

P10 

VDSLST 

0202-0203 

P14 

VPRCED 

0204-0205 

P15 

VINTER 

0206-0207 

P16 

VBREAK 

0208-0209 

P17 

VKEYBD 

020A-020B 

P18 

VSERIN 

020C-020D 

P19 

VSEROR 

020E-020F 

P20 

VSEROC 

0210-0215 

P21 

VITMR1. VITMR2.VITMR4 

0216-0217 

P13 

VIMIRQ 

0218-0219 

P4» H26 

CDTMV1 

021A-021B 

P6 

CDTMV2 

02IC-0221 

P8 

CDTMV3.CDTMV4,CDTMV5 

0222-0223 

Pli 

VVBLKI 

0224-0225 

P12 

VVBLKD 

0226-0227 

PS. H27 

CDTMA1 

0228-0229 

P7 

CDTMA2 

022A 

P9 

CDTMF3 
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022B 

E8 

srtimr 

022C 

P9 

CDTMF4 

022D 

P28 

INTEMP 

022E 

P9 

CDTMF5 

022F 

P22 

SDMCTL 

0230-0231 

P23 

SDLSTL,SDLSTH 

0232 

H32 

SSKCTL 

023A 

H18 

CDEVIC 

023B 

H19 

CCÜMND 

023C-023D 

H20 

CAUX1, CAUX2 

023E 

H23 

TEMP 

023F 

H30 

ERRFLG 

0240 

N8 

DFLAGS 

0241 

N9 

DBSECT 

0242-0243 

N10 

BOOTAD 

0244 

Nil 

COLDST 

0246 

C2 

DSKTIM 

0247-026E 

B51 

LINBUF 

026F 

P24 

GPRIOR 

0270-0277 

J3 

PADDLO — PADDL7 

0278-027B 

Jl, J7, J8 

STICKO — STICK3 

027C-0283 

J4 

PTRIGO — PTRIG7 

0284-0287 

J2, J7, J9 

STRIGO — STRIG3 

0289 

Dl 4 

WMÜDE 

028A 

D10 

BLIM 

028B-028F 

sio 

unused 

0290-0292 

B4 

TXTROW,TXTCOL 

0293 

B49 

TINDEX 

0294-0295 

B52 

TXTMSC 

0296-029B 

B53 

TXTOLD 

029D 

B32 

H0LD3 

029E 

B48 

SUBTMP 

029F 

B3i 

HÜLD2 

02A0 

B28 

DMASK 

02 Ai 

B47 

TMPLBT 

02A2 

B26 

ESCFLG 

02A3-02Bi 

B13 

TABMAP 

02B2-02B5 

Bi4 

LOGMAP 

02B6 

E9 

INVFLG 

02B7 

BIS 

FILFLG 

02B8-02BA 

B46 

TMPROW,TMPCOL 

02BB 

B9 

SCRFLG 

02BC 

B20 

H0LD4 

02BE 

E6 

SHFLQK 

02BF 

B16 

BOTSCR 

02CÖ-02C3 

B7i P27 

PCOLRO — PC0LR3 

02C4-02C8 

BB» P27 

PCOLRO — PC0LR4 

Ö2E4 

AS 

RAMSI2 

02E5-02E6 

A2 

MEMTOP 

02E7-02E8 

Al 

MEMLO 

02EA-02ED 

Gli 

DVSTAT 

02EE-02EF 

Dl 

CHBAUDL,CHBAUDH 

02F0 

Bl 

CRSINH 

02F1 

E2 

KEYDEL 

268 

QPERATING 

SYSTEM C016555 — Appendix 


02F2 

El 

CHI 

02F3 

P25 

CHACT 

02F4 

P26 

CHE AS 

02FA 

B55 

CHAR 

02FB 

B54 

ATACHR 

02FC 

E3 

CH 

02FD 

B17 

FILDAT 

02FE 

B27 

DSPFLC 

02FF 

E4 

SSFLAG 

0300 

Hl, H2 

DCB/DDEVIC 

0301 

H3 

DUN IT 

0302 

H4 

DCOMND 

0303 

H5 

DSTATS 

0304-0305 

H6 

DBUFLO,DBUFHI 

0306 

H7 

DTIMLO 

0308-0309 

H8 

DBYTLO,DBYTHI 

030A-030B 

H9 

DAUX1, DAUX2 

030C-030D 

D3 

TIMER1 

030E 

D4 

ADDCOR 

030F 

D8 

CASFLG 

0310-0311 

D3 

TIMER2 

0312-0313 

D5 

TEMPI 

0315 

D6 

TEMP3 

0316 

D7 

SAVIO 

0317 

D2,H25 

TIMFLG 

0318 

H28 

STACKP 

0319 

H29 

TSTAT 

031A-033F 

G12 

HATABS 

0340 

Gl, G2 

IOCB,ICHID 

0341 

G3 

ICDNO 

0342 

G4 

ICCÜM 

0343 

G5 

ICSTA 

0344-0345 

G6 

ICBAL, ICBAH 


0346-0347 

G7 

ICPTL, ICPTH 

0348-0349 

G8 

ICBLL,ICBLH 

034A-034B 

G9 

ICAX1, ICAX2 

Ö34C-G34F 

G10 

ICSPR 

0350-035F 

G2-G10 

(IOCB #1) 

0360-036F 

G2-G10 

(IOCB #2) 

0370-037F 

G2-G10 

(IOCB #3) 

0380-038F 

G2-G10 

(IOCB #4> 

039Ö-039F 

G2-G10 

(IOCB #5) 

03A0-O3AF 

G2-G10 

(IOCB #6i 

03B0-03BF 

G2-G10 

(IOCB #7) 

03CO-03E7 

Fl 

PRNBUF 

03FD-047F 

D9 

CASBUF 

0480-06FF 

R2 

User Area 
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FLOATING POINT 

00D4-00D9 

OODA-OODF 

00E0-00E5 

00E6-00EB 

OOEC 

OOED 

OOEE 

OOEF 

OOFO 

OOF1 

00F2 

Q0F3-00F4 

OOF5-OOF6 

00F7-00F8 

00F9-00FA 

OOFB 

OOFC-OOFD 

OOFE-OOFF 

057E 

0S7F 

0580-05FF 

05E0-05E5 

05E6-05EB 

05EC-05F1 


270 


PACKAGE VARIABLES 


Ml 

FRO 

M2 

FRE 

M3 

FR1 

M4 

FR2 

M5 

FRX 

M6 

EEXP 

M7 

NSIGN 

M8 

ESIGN 

M9 

FCHRFLG 

MIO 

DIGRT 

Ml 1 

CIX 

M12 

INBUFF 

M13 

ZTEMPI 

M14 

ZTEMP4 

M15 

ZTEMP3 

M24 

RADFLG/DEGFLG 

MIA 

FLPTR 

M17 

FPTR2 

M18 

LBPRi 

M19 

LBPR2 

M20 

LBFEND,LBUFF 

M21 

PLYARG 

M22 

FPSCR/FSCR 

M23 

FPSCR1/SCR1 
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The sub ject index contains three forms of references: 

Section number, such as '3. ' 

Appendix* such as 'App B' 

Variable ID from Appendix L, such as '87'. 


ATARI Standards 
ATASCII 
attract mode 


12 

B54-55. 5, App D-G 

B10-12* 6, 


bit mapped graphics 

blackboard mode 

BNF 

boot 

BREAK 

cartridge 

cassette baud rate determine 
cassette—boot 
cassette device 
Cassette Händler <C> 

CIO (Central I/O Utility) 

C10/user interface 
CIO/Hand 1er interface 
CLOSE I/O command 
coldstart (see 'Power-up') 
color control 
control charaeters 
critical section 
Cursor 

database 

DCB (Device Control Block) 

DELETE I/O command 

development System 

device/filename specification 

Device Händler 

device table 

disk-boot 

disk device 

Disk File Manager (D) 

Disk Händler (resident) 
display device (screen) 
Display Händler <S) 
display list 
DOS (Disk Utilities) 

DRAW I/O command 
driving Controller 
Educational System Format Cas 
error handling 


B2S-B29* S, App H 
3* N12* 7* 12 
1 

3* 4* N3-10, 5* 7. 10 

ES, 6, 12 

3* 4, 7* 10 
D1-D7 

3* N3-1Q* 7* 10 
D1-D15, 3, 5 
5 

01-25, 5* 9 

01-11, 5, App A* App B 

012-22, 9 

5, 9 

B7—8, 5* 6 > 

B26-27, 5, App D 
PI, 6 
81-4, 5 

4 

Hl-9, 5* 9 

5 
13 
5 

S* 9 

2, 012* 5* 7, 9 

3, N3-10, 5, 7, 10 
5 

Kl-5, 5 
Cl-2* 5 

B54-5S* 5, App E, App H 
Bl-55* 5 

4, P10 
LI* 12 

B17-23* 5 
J8-9 

ettes 5 

GS, HS, Hl 1-12, 9, App B-C 
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EOF (end-of-file) 


5 


File Management System 
FILL I/O command 
•Floating point package 
FORMAT I/O command 
free memory 

game Controllers 
CET CHARACTER I/O command 
GET RECORD I/O command 
GET STATUS I/Q c omma n d 

Händler (see 'device handler' 

initializatiam cartridge 
initializatiom Handler 
initia1izatiom Interrupt 
initializatiom System 
internal display Code 
Interrupts 
interrupt mask 
inverse Video (display) 

I/O 

IOCB (I/O Control Block) 

I/O retry logic 

Joystick 

keyboard Autorepeat 
keyboard device 
Keyboard Handler (K) 
keyboard key debouncing 

light pen 
LNBUG 

LOCK I/O command 

logical text lines (screen) 

memory (see 'RAM'» 'ROM" and 
memory dynamics 
memory map 

NÖTE I/O command 

OPEN I/O command 

paddle 
page 0 
page 1 

peripheral devices 
POINT I/O command 
Potuer-up 
Printer device 


5 

Bl 7-25, 5 

2, 4, Ml—24» 8, App J 

5 

4, Al-3, Ri-2, 4, 7 

3, Jl-9, 6, 11 

5, 9 
5, 9 

Gll, 5, 9 

and individual device handlers) 
7 

7, 9 

6 

4, 7, 10 

5, B54 

2, PI — 28» £ 

P2» 6 
E9, 5 

2» 4» 5« 9 
Gl-iO, 5, 9 
Hl 1-12 

Jl-2 

E8 

5 

El-9, 5, App F 
El-3 

11» App J 

13 

5 

B14-15» 5 

'free memory') 

Al-5, Nl-2, 4, 5, 7 

4 

5 

5, 9 
J3-4 

4, Ml-17, RI, 9 

4, 9 
3 

5 

2, NI —13» 4, 7, 12 

5, App G 
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Printer Händler (P) 
program development 
PUT CHARACTER I/O command 
PUT RECORD I/O command 

RAM 

record (X/G> 

RENAME I/O command 

RESET 

ROM (OS) 

RS-232-C Händler (R) 

Screen Editor (E) 

screen margins 

screen modes 

scrolling (text) 

serial I/O bus 

tSHIFT1/CONTROL lock 

SIO (Seria1 bus I/Q Uti 1 i t y ) 

sound control (SIO) 

SPECIAL I/O commands 
split screen 
stack 

Start/stop (display) 
stage 1 VBLANK process 
stage 2 VBLANK process 

tabs (Screen Editor) 
timeout (device) 
timers (System) 

UNLOCK I/O command 
user workspace 

vectors, RAM 
vectors, ROM 
verti ca 1 blank interrupt 

Warmstart (see 'RESET') 
wild-card (disk filename) 

ZIOCB (Zero-page IOCB) 


FI-5t 
13 

5, 9 
5> 9 

3, 4t 9 
5 

5 

2t Nl-13, 6, 7, 12 

lt 4 
5t 9 

Bl-55, 5 
B5-6» 5, 7 
4t 5t App H 
B9t 5 

3t 5, 9, App I 
E6-7, 5 

Hl-32t P13-21, 5, 9, App C 
HiOt 11 
5, 9 
B16, 5 

4 

E4, 5, 12 

P3-5» 6 

P6-9t P22-27, 6 

B13, 5 
H25-27, 9 
P3-9, 6 

5 

4, M1S-23, R2 

P5, P7, P10-21, 6, 9 

5, 9, App J 
PI 1-12, 6 


5 

Gl3-22, 9, 0020t16 
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